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

# FAQ

***

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

**Resposta:**

O Face Authenticator SDK fornece uma solução para verificar se o rosto capturado pela câmera de um dispositivo móvel é de uma pessoa viva 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 (Know Your Customer), prevenção a fraudes e acesso seguro.

***

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

**Resposta:**

**React Native:** O SDK é compatível com versões do React Native que sejam **0.73.x** ou superiores.

**Android:** O SDK é compatível com Android API 21 e superior, garantindo compatibilidade com dispositivos Android modernos. Seu projeto Android deve usar uma **versão mínima do SDK de 21**.

**iOS:** O SDK é compatível com 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-authenticator/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 elas 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 elas 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 Authenticator 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-authenticator
   ```
2. Configure as permissões necessárias para acesso à câmera e à internet nos arquivos `AndroidManifest.xml` (para Android) e `Info.plist` (para iOS) do seu app.
3. Conclua qualquer configuração adicional no `build.gradle` (para Android) e `Podfile` (para iOS). Para instruções detalhadas, consulte a [seção de Instalação](/caf-sdk/caf-sdk-pt-br/react-native/standalone-modules/face-authenticator/installation.md).

***

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

**Resposta:**

Sim, o Face Authenticator SDK pode ser usado com o Expo, mas apenas no [Bare Workflow](https://docs.expo.dev/more/glossary-of-terms/#bare-workflow), que permite as configurações nativas necessárias. Além disso, você deve usar um [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 de Instalação](/caf-sdk/caf-sdk-pt-br/react-native/standalone-modules/face-authenticator/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-authenticator/current-version.md).

***

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

**Resposta:**

Para iniciar a verificação do autenticador, siga estas etapas:

1. Importe e use a `startFaceAuthenticator` função.
2. Inicie a atividade do autenticador.
3. Capture o resultado no `usarAutenticadorFacial` hook.

Para mais detalhes sobre como iniciar o processo, consulte a [seção Iniciar SDK](/caf-sdk/caf-sdk-pt-br/react-native/standalone-modules/face-authenticator/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 autenticação 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-authenticator/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-authenticator/faq_face_authenticator_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.
