> 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](/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 a 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) | [Perguntas frequentes](/caf-sdk/caf-sdk-pt-br/ios/standalone-modules/caffacelivenesslite/faq_caf_face_liveness_sdk.md)

***

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

**Resposta:**

O Lite SDK fornece um fluxo menor e simplificado 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:**

Compatível com iOS 15.0+, Xcode 26.0+ e Swift 6.3+. Veja o [Requisitos](/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 ATS, se necessário)

***

## **4. Como integro o Lite SDK ao meu projeto iOS?**

**Resposta:**

Use SPM ou CocoaPods para adicionar dependências, depois instancie `CafFaceLivenessLiteSDK`, defina seu delegate, chame `setup` com suas credenciais e chame `startSDK`. Veja [Instalação](/caf-sdk/caf-sdk-pt-br/ios/standalone-modules/caffacelivenesslite/installation.md) e [Iniciar SDK](/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 [Iniciar SDK](/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 de resultado](/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, passe também `customLocalizationBundle` (por exemplo `Bundle(for: CafFaceLivenessLiteSDK.self)`). Veja [Localização do iProov](https://github.com/iProov/ios/wiki/Localization).

***

## **8. Posso encadear FaceAuth após a vivacidade?**

**Resposta:**

Não. Em **2.0.0**, `executeFaceAuth` foi removido — 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 vivacidade.

***

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

**Resposta:**

Após a captura, o SDK chama a rota assíncrona e retorna apenas um JWT opaco via `signedResponse` JWT via `didFinishWithSuccess` / `didFinishWithFailure`. Seu backend deve resolver o resultado final de vivacidade (`isAlive`, imagens) fora de banda. O SDK não faz polling.

***

## **10. O que é o parâmetro `enableSecurity` 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 de teste de UI automatizado em que o executor de testes gera falsos positivos. **Mantenha-o ativado em builds de produção.**

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

// Apenas em testes 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 ponto em que o usuário já esteja ocupado — uma tela de instruções, uma etapa de consentimento, um formulário —, para que a ida e volta aconteça durante o tempo de leitura dele.

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

`prewarm()` não retorna nada — ele não tem handler de conclusão e nunca chama o delegate. Observe que, no caminho prewarmed, nenhum `loading()` / `loaded()` é 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 aparece
sdk.startSDK(viewController: self)  // consome a sessão prewarmed
```


---

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