Ctrlk
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Perguntas frequentes

Links rápidos: Visão geral | Compilando o SDK | Iniciar verificação de vivacidade | Personalização da interface | Instalação | Versão atual | Requisitos | Código-fonte | Referência de resultados | Notas da versão | Perguntas frequentes

1. O que é o SDK CafFaceLivenessLite e qual é sua funcionalidade principal?

Resposta:

O Lite SDK oferece um fluxo de verificação de vivacidade facial menor e simplificado. Ele detecta tentativas de spoofing para proteger o cadastro e a autenticação.

2. Quais são os requisitos de sistema para o Lite SDK no iOS?

Resposta:

Compatível com iOS 15.0+, Xcode 26.0+ e Swift 6.3+. Veja o Requisitos.

3. Quais permissões são necessárias para usar o Lite SDK?

Resposta:

  • Acesso à câmera (NSCameraUsageDescription em Info.plist)

  • Acesso à internet (exceções ATS, se necessário)

4. Como integro o Lite SDK ao meu projeto iOS?

Resposta:

Use SPM ou CocoaPods para adicionar dependências e, em seguida, instancie CafFaceLivenessLiteSDK, defina seu delegate e chame startSDK. Veja Instalação e Iniciar SDK.

5. Como inicio o processo de verificação de Face Liveness?

Resposta:

  1. Defina o delegate.

  2. Chame startSDK com viewController, mobileToken, e personId.

  3. Lide com os callbacks em CafFaceLivenessLiteDelegate.

Veja Iniciar SDK.

6. Quais erros e falhas devo tratar?

Resposta:

Trate didFinishWithError(type:description:) para erros de execução (câmera, rede, token) e didFinishWithFailure(type:description:signedResponse:) para falhas de negócio (iluminação, alinhamento). Veja Referência de resultados.

7. Posso personalizar textos ou a localização?

Resposta:

Sim. Passe customLocalization (nome da tabela de strings, omita .strings) para startSDK. Se as strings estiverem fora do bundle principal do app, passe também customLocalizationBundle (por exemplo Bundle(for: CafFaceLivenessLiteSDK.self)). Veja Localização do iProov.

8. Posso encadear o FaceAuth após a vivacidade?

Resposta:

Não. A partir de 2.0.0, executeFaceAuth foi removido — o Face Auth está fora do escopo do fluxo Lite assíncrono. Use os produtos completos Face Liveness / Face Auth se precisar de autenticação após a vivacidade.

9. O que significa signedResponse em 2.0.0?

Resposta:

Após a captura, o SDK chama a rota assíncrona e retorna apenas um signedResponse JWT opaco via didFinishWithSuccess / didFinishWithFailure. Seu backend deve resolver o resultado final de vivacidade (isAlive, imagens) fora de banda. O SDK não faz polling.

10. O que é o enableSecurity parâmetro e quando devo desativá-lo?

Resposta:

enableSecurity é um parâmetro do construtor (padrão: true) que ativa o monitoramento de segurança — detecção de jailbreak, monitoramento de dylib e detecção de instrumentação. Quando uma violação é detectada, didFinishWithError é chamado com CafErrorType.securityException.

Desative-o (enableSecurity: false) somente em ambientes automatizados de teste de UI em que o executor de testes gera falsos positivos. Mantenha-o ativado em builds de produção.

Atualizado