> 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/faq_caf_face_liveness_sdk.md).

# Perguntas frequentes

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

***

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

**Resposta:**

O Lite SDK fornece um fluxo menor e mais enxuto de verificação de vivacidade facial. Ele detecta tentativas de spoofing para proteger o onboarding e a autenticação.

***

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

**Resposta:**

Suporta iOS 15.0+, Xcode 26.0+ e Swift 6.3+. Veja a [Requisitos](https://docs.caf.io/caf-sdk/caf-sdk-pt-br/ios/standalone-modules/caffacelivenesslite/requirements.md).

***

## **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 de 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, chame `setup` com suas credenciais e chame `startSDK`. Veja [Instalação](https://docs.caf.io/caf-sdk/caf-sdk-pt-br/ios/standalone-modules/caffacelivenesslite/installation.md) e [Start SDK](https://docs.caf.io/caf-sdk/caf-sdk-pt-br/ios/standalone-modules/caffacelivenesslite/start-sdk.md).

***

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

**Resposta:**

1. Defina o delegate.
2. Chame `setup` com `mobileToken` e `personId`.
3. Opcionalmente, chame `prewarm()` para solicitar a sessão com antecedência.
4. Chame `startSDK` com `viewController`.
5. Trate os callbacks em `CafFaceLivenessLiteDelegate`.

Veja [Start SDK](https://docs.caf.io/caf-sdk/caf-sdk-pt-br/ios/standalone-modules/caffacelivenesslite/start-sdk.md).

***

## **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 do resultado](https://docs.caf.io/caf-sdk/caf-sdk-pt-br/ios/standalone-modules/caffacelivenesslite/result-reference.md).

***

## **7. Posso personalizar textos ou localização?**

**Resposta:**

Sim. Passe `customLocalization` (nome da tabela de strings, omita `.strings`) para `setup`. Se as strings estiverem fora do bundle principal do app, também passe `customLocalizationBundle` (por exemplo `Bundle(for: CafFaceLivenessLiteSDK.self)`). Veja [Localização do iProov](https://github.com/iProov/ios/wiki/Localization).

***

## **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 assíncrono do Lite. Use os produtos completos Face Liveness / Face Auth se precisar de autenticação após a verificação de vivacidade.

***

## **9. O que `signedResponse` significa e quando ele é entregue?**

**Resposta:**

O `signedResponse` é um JWT opaco emitido quando a sessão de vivacidade é criada. A partir de **3.1.0**, ele é entregue no momento em que a captura é concluída, por meio de `didFinishWithSuccess` e também por meio de `didFinishWithFailure`, onde ele sempre está presente. Seu backend deve resolver o resultado final de vivacidade (`isAlive`, imagens) fora de banda. O SDK não faz polling.

***

## **10. Qual é 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`) apenas em ambientes automatizados de teste de UI em que o executador de testes dispara falsos positivos. **Mantenha-o ativado em builds de produção.**

```swift
// Produção
let sdk = CafFaceLivenessLiteSDK(enableSecurity: true)

// Apenas teste de UI
let sdk = CafFaceLivenessLiteSDK(enableSecurity: false)
```

***

## **11. O que `prewarm()` faz e quando devo chamá-lo?**

**Resposta:**

`prewarm()` executa a solicitação da sessão com antecedência para que `startSDK` possa abrir a câmera sem esperar pela rede. Chame-o depois de `setup`, em um momento em que o usuário já está ocupado — uma tela de instruções, uma etapa de consentimento, um formulário — para que a ida e volta coincida com o tempo de leitura dele.

É totalmente opcional. Uma sessão pré-aquecida é válida por **90 segundos** e é consumida pela próxima `startSDK` chamada. Se ela estiver ausente, expirada ou tiver sido criada com credenciais diferentes, `startSDK` faz fallback silenciosamente para solicitar a sessão de forma inline, então o pré-aquecimento nunca pode quebrar uma captura. Se você nunca o chamar, o fluxo se comporta exatamente como fazia antes da 3.0.0.

`prewarm()` não informa nada — ele não possui handler de conclusão e nunca chama o delegate. Observe que, no caminho pré-aquecido, nenhum `loading()` / `loaded()` par é emitido para a solicitação da sessão.

```swift
sdk.setup(mobileToken: "your_mobile_token", personId: "your_person_id")
sdk.prewarm()                       // por exemplo, quando a tela de instruções aparecer
sdk.startSDK(viewController: self)  // consome a sessão pré-aquecida
```


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
