Problemas conhecidos

• CSP bloqueia o carregamento do SDK — sem as diretivas de CSP necessárias (worker-src, script-src, etc.), o Web SDK não consegue carregar Web Workers e recursos adicionais. Revise a configuração de CSP.

• prepareSelfieCameraForIFrame fora de um iFrame retorna o erro 73724 — o método de iFrame só funciona dentro de um iFrame. Use prepareSelfieCamera para contextos fora do iFrame. O inverso também é verdadeiro.

• Tela cheia no iPhone é restrita — a Apple restringe o uso de APIs de tela cheia especificamente no iPhone (iPads são aceitáveis). Para capturas no iPhone, configure manualmente o posicionamento do iFrame.

• Frame distorcido pelo CSS do elemento pai — design systems com componentes de grid (Bootstrap, Material-UI, etc.) podem interferir no frame de captura. Posicione o frame (id="box-camera") onde ele não herde regras CSS indesejadas.

• Smart camera falha no Web Mobile quando o frame não é 100vw/100vh — para mobile, o frame de captura deve ocupar 100% da tela do dispositivo para evitar problemas com os algoritmos de visão computacional.

• Liveness com interação não funciona em WebViews de redes sociais — o Liveness sem interação é aprovado nas WebViews do Instagram e Facebook; a variante interativa não é suportada.