Referência de resultados
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
CafFaceLivenessLiteResult – Evento de sucesso
signedResponse
JWT opaco retornado pela rota assíncrona. Encaminhe-o para o seu backend; o SDK não retorna isAlive ou imagens.
De 2.0.0, uma captura bem-sucedida inicia uma transação assíncrona. Use signedResponse com o seu backend para obter o resultado final de vivacidade.
CafErrorType – Tratamento de erros
Tipos comuns de erro retornados via didFinishWithError(type:description:):
unsupportedDevice
O dispositivo não atende aos requisitos mínimos de hardware/software
cameraPermission
Permissão da câmera não concedida
networkException
Erro relacionado à rede (sem internet, timeout etc.)
serverException
Erro de processamento no servidor
tokenException
Token inválido ou expirado
captureAlreadyActiveException
Uma captura anterior ainda está ativa
userTimeoutException
O usuário não concluiu a captura a tempo
imageNotFoundException
Imagem da captura não encontrada
tooManyRequestsException
Limitação de taxa / muitas solicitações
invalidResponseException
Resposta do servidor inválida ou malformada
permissionException
Erro genérico de permissão do sistema operacional
libraryException
Falha da biblioteca subjacente
unexpectedErrorException
Erro interno inesperado
unknownException
Erro não especificado
cameraException
Erro de hardware da câmera
certificateException
Falha na validação do certificado
invalidOptionsException
Opções de configuração inválidas fornecidas para o SDK
securityException
Violação de segurança detectada (acionada quando enableSecurity: true e instrumentação ou hooking é detectado)
CafFailureType – Referências de falha
Códigos de feedback disponíveis retornados via didFinishWithFailure(type:description:signedResponse:):
unknown
Tente novamente
✅
❌
tooMuchMovement
Fique parado
✅
❌
tooBright
Vá para um local mais escuro
✅
❌
tooDark
Vá para um local mais claro
✅
❌
misalignedFace
Mantenha seu rosto dentro do oval
✅
❌
faceTooFar
Aproxime o rosto da tela
✅
❌
faceTooClose
Afaste o rosto da tela
✅
❌
sunglasses
Remova os óculos de sol
✅
❌
systemError
Erro do sistema
⚠️
✅
rejected
A transação não pôde ser concluída
⚠️
✅
faceNotFound
Alinhe seu rosto no oval e depois tente ficar parado
⚠️
✅
obscuredFace
Certifique-se de que todo o seu rosto esteja visível e remova qualquer acessório que possa cobrir seu rosto
✅
✅
timeout
Tempo limite do sistema
⚠️
✅
eyewear
Remova seus óculos
⚠️
✅
multipleFaces
Certifique-se de que apenas uma pessoa esteja visível
✅
✅
eyesClosed
Certifique-se de que seus olhos estejam abertos
✅
✅
userNotFound
A transação não pôde ser concluída
⚠️
✅
lightingIssues
Certifique-se de que seu rosto esteja bem iluminado e sem reflexos
⚠️
✅
framesBlurry
Alinhe seu rosto no oval e depois tente ficar parado
⚠️
✅
deviceIssue
Tente usar outro dispositivo
⚠️
✅
motionIssue
Alinhe seu rosto no oval e depois tente ficar parado
⚠️
✅
backgroundIssue
Mude para outro local com um fundo neutro
⚠️
✅
deviceRestart
Reinicie seu dispositivo e tente novamente
⚠️
✅
processingFault
Tente novamente
⚠️
✅
Chave: ✅ = será retornado, ❌ = não será retornado, ⚠️ = pode ser retornado no futuro
Atualizado