SDK 2.0.0. Autenticação: Autenticação e licença. Enums: Enums de parâmetros.
Integração
A criação do mecanismo / init() falhou
EngineConfigprecisa de umlicenseTokennão vazio. Não há camposappId/appKeyna config Web.- Produção: seu servidor precisa devolver o corpo da API de autenticação (
{success, token}ou JSON de erro). Veja Autenticação e licença. - Confirme que a página consegue baixar os arquivos de runtime do SDK (bundler / CDN). Veja Tratamento de erros.
- Confirme que a página está em HTTPS ou localhost.
- Verifique
FacebetterError.code(Tratamento de erros).
Como eu passo AppID / AppKey?
Você não passa — não emEngineConfig. Guarde-os no servidor, busque um token e passe licenseToken.
Posso usar um .lic offline no navegador?
Não. A Web precisa concluir um caminho online v2.
Como eu atualizo o pacote?
Efeitos
A beleza parece fraca ou forte demais
As intensidades são[0.0, 1.0]. A remodelagem é [-1.0, 1.0] (0 = desligado). Tente FrameType.Image para stills. Enums de estilo: Enums de parâmetros.
O filtro / adesivo não faz nada
Passe o caminho ou bytes.fbd diretamente para setFilter / setSticker. String vazia lança — chame clearFilter() / clearSticker().
O fundo virtual fica em branco
ChamesetVirtualBackgroundBlur(level) ou setVirtualBackground(path|Uint8Array), não um objeto de opções. Desfoque 0 limpa o efeito. Para tela verde, setChromaKey só define a máscara; ainda defina desfoque ou uma imagem.
A saída está preta
O vídeo pode ainda não ter um quadro (videoWidth === 0). Contexto do canvas ausente. Chame processImage somente após engine.initialized.
Desempenho
A prévia está lenta
Câmera: useFrameType.Video, limite a resolução de captura (por exemplo 720p), evite callbacks de landmarks e rode o loop em requestAnimationFrame. Observe engine.getStats().avgProcessTimeMs.
Em stills grandes da galeria, não envie o original para processImage a cada tick do slider. Crie um quadro de prévia menor ao abrir o arquivo; exporte o original uma vez. Veja Práticas recomendadas.
A memória cresce em um SPA
Chameengine.destroy() ao sair da página. Não vaze mecanismos entre mudanças de rota.
Compatibilidade
Suportados: Chrome 57+, Firefox 52+, Safari 11+, Edge 16+. No mobile, reduza a resolução de captura e as intensidades dos efeitos.Exemplo React
demo/web/react no repositório do SDK.

