Developer Preview
Web 0.2.0 applies compatible authored packages. It does not expose the mobile SDK's direct runtime PNG, JPEG, or animated GIF face-sticker API.
Prerequisites
- A working Web quickstart
- Access to the authorized Web
0.2.0developer preview - A package marked compatible with the Web preview
Choose compatible content
On Web, stickers and overlays are delivered as compatible authored effect packages. A package may contain a face mask, image overlay, animation, particles, triggers, or supported 3D content.
Use only an item marked as compatible with the authorized Web preview. Mobile package compatibility does not automatically guarantee Web compatibility.
Apply the overlay
Use the authorized package URL or package data supplied by the application.
const result = await sdk.applyEffect(selectedOverlayUrl);
if (!result.success) {
throw new Error(result.error ?? 'AR overlay could not be applied');
}
console.info('Overlay compatibility', result.compatibility);
The authored package owns its supported face tracking, animation, triggers, and visual resources. The Web preview does not expose raw face landmarks to the application.
Remove or replace it
await sdk.removeEffect();
Applying another package to the same visual category replaces the active package.
Verify
Test face loss and return, head rotation, camera permission restart, tab visibility changes, HTTPS deployment, and the browsers targeted by the application.
Common errors
| Symptom | Fix |
|---|---|
| Mobile effect is rejected | Select a package marked as compatible with Web 0.2.0 |
| Package request fails | Check HTTPS, URL, CORS, Content Security Policy, and authorized asset hosting |
| Direct face-sticker method is unavailable | Use a compatible authored package; the mobile runtime sticker API is not available on Web |