> 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 de resultado

Links rápidos: [Visão geral](/caf-sdk/caf-sdk-pt-br/ios/standalone-modules/caffacelivenesslite.md) | [Compilando 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 resultados](/caf-sdk/caf-sdk-pt-br/ios/standalone-modules/caffacelivenesslite/result-reference.md) | [Notas da versão](/caf-sdk/caf-sdk-pt-br/ios/standalone-modules/caffacelivenesslite/release-notes.md) | [Perguntas frequentes](/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 retornado pela rota assíncrona. Encaminhe-o para o seu backend; o SDK não retorna `isAlive` ou imagens. |

{% hint style="info" %}
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.
{% endhint %}

### CafErrorType – Tratamento de erros

Tipos comuns de erro retornados via `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 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:)`:

| Valor do enum     | Descrição localizada (inglês)                                                                               | GPA | LA |
| ----------------- | ----------------------------------------------------------------------------------------------------------- | --- | -- |
| `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


---

# 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.