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

Referência de resultado

CafFaceLivenessLiteResult – Evento de sucesso

Campo
Descrição

signedResponse

JWT opaco emitido com a sessão de liveness. Encaminhe-o para o seu backend; o SDK não o retorna isAlive ou imagens.

De 3.1.0, o signedResponse é emitido quando a sessão de liveness é criada e entregue ao seu delegate no momento em que a captura é concluída — não há espera após a captura. Use-o com seu backend para obter o resultado final de liveness, conforme descrito em Configuração do backend; o SDK não faz polling por ele.

CafErrorType – Tratamento de erros

O SDK informa erros de execução por meio de didFinishWithError(type:description:). Apenas os tipos de erro abaixo são retornados por CafFaceLivenessLite. Para saber quando cada um é esperado e como orientar o usuário, consulte Tratamento de erros:

CafErrorType é compartilhado com outros SDKs da Certta e também declara imageNotFoundException, tooManyRequestsException, permissionException, libraryException, unknownException, cameraException, certificateException, faceAuthentication e livenessException. CafFaceLivenessLite nunca os retorna. Se você alternar para CafErrorType, adicione um padrão caso em vez de tratar cada um deles.

CafFailureType – Referências de falha

Códigos de feedback disponíveis retornados via didFinishWithFailure(type:description:signedResponse:). O tipo é o motivo mais provável da falha, e qualquer código que o SDK não reconheça é retornado como unknown. descrição contém a mensagem localizada para esse motivo, e signedResponse está sempre presente — é o mesmo JWT emitido com a sessão, então encaminhe-o para o seu backend como faria no sucesso:

Valor do enum
Descrição localizada (em inglês)

unknown

Tente novamente

tooMuchMovement (legado)

Fique imóvel

tooBright (legado)

Vá para um local mais escuro

tooDark (legado)

Vá para um local mais claro

misalignedFace (legado)

Mantenha seu rosto dentro do oval

faceTooFar (legado)

Aproxime seu rosto da tela

faceTooClose (legado)

Afaste seu rosto da tela

sunglasses (legado)

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 então tente ficar imóvel

obscuredFace

Certifique-se de que todo o seu rosto esteja visível e remova quaisquer acessórios que possam 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 então tente ficar imóvel

deviceIssue

Tente usar outro dispositivo

motionIssue

Alinhe seu rosto no oval e então tente ficar imóvel

backgroundIssue

Vá para outro local com um fundo neutro

deviceRestart

Reinicie seu dispositivo e tente novamente

processingFault

Tente novamente

Os valores marcados como legado são mantidos por compatibilidade, mas as versões atuais não os retornam mais. Consulte Tipos legados para o equivalente atual de cada um.

O descrição carrega o texto localizado do mecanismo de liveness para esse motivo. Não o exiba como está: mapeie o tipo para a mensagem recomendada em Motivos da falha e orientação ao usuário, que foi escrita para orientar a próxima tentativa sem revelar o que foi detectado.

Próximo passo

Encaminhe o signedResponse para o seu backend, que o valida e obtém o resultado: Configuração do backend.

Atualizado