> For the complete documentation index, see [llms.txt](https://docs.caf.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.caf.io/caf-sdk/caf-sdk-pt-br/ios/standalone-modules/caffacelivenesslite/result-reference.md).

# Referência do resultado

Links rápidos: [Visão geral](/caf-sdk/caf-sdk-pt-br/ios/standalone-modules/caffacelivenesslite.md) | [Construindo o SDK](/caf-sdk/caf-sdk-pt-br/ios/standalone-modules/caffacelivenesslite/builder.md) | [Iniciar verificação de vivacidade](/caf-sdk/caf-sdk-pt-br/ios/standalone-modules/caffacelivenesslite/start-sdk.md) | [Personalização da interface](/caf-sdk/caf-sdk-pt-br/ios/standalone-modules/caffacelivenesslite/ui-customization.md) | [Instalação](/caf-sdk/caf-sdk-pt-br/ios/standalone-modules/caffacelivenesslite/installation.md) | [Versão atual](/caf-sdk/caf-sdk-pt-br/ios/standalone-modules/caffacelivenesslite/current-version.md) | [Requisitos](/caf-sdk/caf-sdk-pt-br/ios/standalone-modules/caffacelivenesslite/requirements.md) | [Código-fonte](/caf-sdk/caf-sdk-pt-br/ios/standalone-modules/caffacelivenesslite/source-code.md) | [Referência de resultado](/caf-sdk/caf-sdk-pt-br/ios/standalone-modules/caffacelivenesslite/result-reference.md) | [Notas de versão](/caf-sdk/caf-sdk-pt-br/ios/standalone-modules/caffacelivenesslite/release-notes.md) | [FAQ](/caf-sdk/caf-sdk-pt-br/ios/standalone-modules/caffacelivenesslite/faq_caf_face_liveness_sdk.md)

### CafFaceLivenessLiteResult – Evento de sucesso

| Campo            | Descrição                                                                                                             |
| ---------------- | --------------------------------------------------------------------------------------------------------------------- |
| `signedResponse` | JWT opaco emitido com a sessão de vivacidade. Encaminhe-o para o seu backend; o SDK não retorna `isAlive` ou imagens. |

{% hint style="info" %}
De **3.1.0**, o `signedResponse` é emitido quando a sessão de vivacidade é 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 o seu backend para obter o resultado final da vivacidade; o SDK não faz polling por ele.
{% endhint %}

### CafErrorType – Tratamento de erros

Tipos comuns de erro retornados por `didFinishWithError(type:description:)`:

| Erro                            | Descrição                                                                                                        |
| ------------------------------- | ---------------------------------------------------------------------------------------------------------------- |
| `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 na 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 do SDK fornecidas, ou `startSDK` chamado antes de `setup`                       |
| `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 por `didFinishWithFailure(type:description:signedResponse:)`:

| Valor do enum             | Descrição localizada (inglês)                                                                               | GPA | LA |
| ------------------------- | ----------------------------------------------------------------------------------------------------------- | --- | -- |
| `desconhecido`            | Tente novamente                                                                                             | ✅   | ❌  |
| `movimento excessivo`     | Fique parado                                                                                                | ✅   | ❌  |
| `muito claro`             | Vá para um lugar mais escuro                                                                                | ✅   | ❌  |
| `muito escuro`            | Vá para um lugar mais claro                                                                                 | ✅   | ❌  |
| `rosto desalinhado`       | Mantenha o rosto no oval                                                                                    | ✅   | ❌  |
| `rosto muito distante`    | Aproxime o rosto da tela                                                                                    | ✅   | ❌  |
| `rosto muito perto`       | Afaste o rosto da tela                                                                                      | ✅   | ❌  |
| `óculos escuros`          | Remova os óculos escuros                                                                                    | ✅   | ❌  |
| `systemError`             | Erro do sistema                                                                                             | ⚠️  | ✅  |
| `rejeitado`               | A transação não pôde ser concluída                                                                          | ⚠️  | ✅  |
| `faceNotFound`            | Alinhe seu rosto no oval e depois tente ficar parado                                                        | ⚠️  | ✅  |
| `rosto obstruído`         | Certifique-se de que todo o seu rosto esteja visível e remova qualquer acessório que possa cobrir seu rosto | ✅   | ✅  |
| `timeout`                 | Timeout do sistema                                                                                          | ⚠️  | ✅  |
| `óculos`                  | Remova seus óculos                                                                                          | ⚠️  | ✅  |
| `multipleFaces`           | Certifique-se de que apenas uma pessoa esteja visível                                                       | ✅   | ✅  |
| `olhos fechados`          | Certifique-se de que seus olhos estejam abertos                                                             | ✅   | ✅  |
| `userNotFound`            | A transação não pôde ser concluída                                                                          | ⚠️  | ✅  |
| `problemas de iluminação` | Certifique-se de que seu rosto esteja bem iluminado e sem reflexos                                          | ⚠️  | ✅  |
| `framesBlurry`            | Alinhe seu rosto no oval e depois tente ficar parado                                                        | ⚠️  | ✅  |
| `problema no dispositivo` | Tente outro dispositivo                                                                                     | ⚠️  | ✅  |
| `problema de movimento`   | Alinhe seu rosto no oval e depois tente ficar parado                                                        | ⚠️  | ✅  |
| `problema de fundo`       | Mude para outro local com um fundo neutro                                                                   | ⚠️  | ✅  |
| `reinício do dispositivo` | Reinicie o seu dispositivo e tente novamente                                                                | ⚠️  | ✅  |
| `falha de processamento`  | Tente novamente                                                                                             | ⚠️  | ✅  |

Legenda: ✅ = será retornado, ❌ = não será retornado, ⚠️ = pode ser retornado no futuro


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.caf.io/caf-sdk/caf-sdk-pt-br/ios/standalone-modules/caffacelivenesslite/result-reference.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.