> 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/react-native/standalone-modules/face-liveness/faq_face_liveness_sdk.md).

# FAQ

***

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

**Resposta:**

O Face Liveness SDK oferece uma solução para verificar se o rosto capturado pela câmera de um dispositivo móvel é de uma pessoa real e não de uma foto, vídeo ou outras formas de spoofing. Ele é amplamente usado em cenários em que a verificação de identidade é crucial, como KYC (Conheça Seu Cliente), prevenção a fraudes e acesso seguro.

***

## **2. Quais são os requisitos de sistema para o Face Liveness SDK no React Native?**

**Resposta:**

**React Native:** O SDK oferece suporte a versões do React Native que sejam **0.73.x** ou superior.

**Android:** O SDK oferece suporte ao Android API 21 e superior, garantindo compatibilidade com dispositivos Android modernos. Seu projeto Android deve usar um **versão mínima do SDK de 21**.

**iOS:** O SDK oferece suporte ao iOS 13 e superior, garantindo compatibilidade com dispositivos iOS modernos. Seu projeto iOS deve usar um **target mínimo de implantação do iOS 13**.

Para mais detalhes sobre os requisitos, consulte a [seção Requisitos](/caf-sdk/caf-sdk-pt-br/react-native/standalone-modules/face-liveness/requirements.md).

***

## **3. Quais permissões são necessárias para usar o SDK?**

**Resposta:**

O SDK requer as seguintes permissões:

* Configuração do Android:
  * Câmera (`android.permission.CAMERA`)
  * Internet (`android.permission.INTERNET`)

Certifique-se de que estas sejam adicionadas ao seu `AndroidManifest.xml` e trate as solicitações de permissão no seu app de forma apropriada para versões do Android que exigem solicitações de permissão em tempo de execução.

* Configuração do iOS:
  * Câmera (`Privacidade - Descrição de Uso da Câmera`)

Certifique-se de que estas sejam adicionadas ao seu `Info.plist` e trate as solicitações de permissão no seu app de forma apropriada para versões do iOS que exigem solicitações de permissão em tempo de execução.

***

## **4. Como integro o Face Liveness SDK ao meu projeto React Native?**

**Resposta:**

Para integrar o SDK:

1. Adicione o pacote do SDK ao seu projeto executando:

   ```sh
   npm intall @caf.io/react-native-face-liveness
   ```
2. Configure as permissões necessárias para acesso à câmera e à internet no `AndroidManifest.xml` (para Android) e `Info.plist` (para iOS).
3. Conclua qualquer configuração adicional no `build.gradle` (para Android) e `Podfile` (para iOS). Para instruções detalhadas, consulte a [seção Instalação](/caf-sdk/caf-sdk-pt-br/react-native/standalone-modules/face-liveness/installation.md).

***

## **5. O Face Liveness SDK é compatível com o Expo?**

**Resposta:**

Sim, o Face Liveness SDK pode ser usado com o Expo, mas somente no [Bare Workflow](https://docs.expo.dev/more/glossary-of-terms/#bare-workflow), o que permite as configurações nativas necessárias. Além disso, você deve usar uma [build de desenvolvimento](https://docs.expo.dev/develop/development-builds/create-a-build/) no Expo, pois o SDK depende de código nativo que não está disponível no fluxo de trabalho gerenciado.

* Configuração do Android:
  1. Adicione os seguintes repositórios Maven ao `android/build.gradle`:

     ```gradle
     allprojects { 
         repositories { 
             ... 
             maven { url 'https://repo.combateafraude.com/android/release' }
             maven { url 'https://raw.githubusercontent.com/iProov/android/master/maven/' }
             maven { url 'https://maven.fpregistry.io/releases' }
             maven { url 'https://jitpack.io' }
         } 
     }     
     ```
  2. Garanta a compatibilidade com Java 8 configurando `android/app/build.gradle`.

     ```gradle
     android {
         ...
         compileOptions {
             sourceCompatibility JavaVersion.VERSION_1_8
             targetCompatibility JavaVersion.VERSION_1_8
         }
     }
     ```
* Configuração do iOS:
  1. Adicione as seguintes fontes ao seu `Podfile` para acessar as dependências necessárias.

     ```ruby
     source 'https://github.com/combateafraude/iOS.git'
     source 'https://cdn.cocoapods.org'
     ```

Essas configurações permitem que o SDK funcione de forma eficaz em um ambiente Expo com suporte nativo.

Para instruções detalhadas, consulte a [seção Instalação](/caf-sdk/caf-sdk-pt-br/react-native/standalone-modules/face-liveness/installation.md).

***

## **6. Qual é a versão atual do SDK e onde posso encontrar detalhes específicos da versão?**

**Resposta:**

A versão atual do SDK é atualizada regularmente. Você pode encontrar as informações da versão mais recente, incluindo changelogs e detalhes específicos da versão, [aqui](/caf-sdk/caf-sdk-pt-br/react-native/standalone-modules/face-liveness/current-version.md).

***

## **7. Como inicio o processo de verificação de Face Liveness no meu app?**

**Resposta:**

Para iniciar a verificação de vivacidade, siga estas etapas:

1. Importe e use a `startFaceLiveness` função.
2. Inicie a atividade de verificação de vivacidade.
3. Capture o resultado no `useFaceLiveness` hook.

Para mais detalhes sobre como iniciar o processo, consulte a [seção Start SDK](/caf-sdk/caf-sdk-pt-br/react-native/standalone-modules/face-liveness/start-sdk.md).

***

## **8. Quais são os erros ou problemas típicos que podem ocorrer e como posso solucioná-los?**

**Resposta:**

Alguns erros comuns incluem:

* **Permissão da câmera não concedida**: Certifique-se de que seu app solicite as permissões necessárias em tempo de execução.
* **Falha na inicialização do SDK**: Verifique sua configuração do Gradle e certifique-se de que o SDK esteja inicializado corretamente no ciclo de vida do app.
* **Erros de rede**: Certifique-se de que o dispositivo tenha uma conexão ativa com a internet para que a verificação de vivacidade seja bem-sucedida.

Para mais detalhes de solução de problemas, consulte a [seção de Referências do TypeScript](/caf-sdk/caf-sdk-pt-br/react-native/standalone-modules/face-liveness/typescript-references.md#error).


---

# 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/react-native/standalone-modules/face-liveness/faq_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.
