> 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/document-detector/faq_document_detector_sdk.md).

# FAQ

***

## **1. O que é o SDK do Document Detector e qual é sua funcionalidade principal?**

**Resposta:**

O SDK do Document Detector foi projetado para capturar documentos de identidade, como RG, CNH e RNE, com imagens de alta qualidade e extração de dados confiável. Em vez de depender de uma câmera padrão, ele utiliza uma câmera inteligente com recursos como captura automática e detecção de documentos, reduzindo a chance de fotos de baixa qualidade ou inutilizáveis. Essa funcionalidade aprimora os processos de onboarding, garantindo que os documentos sejam capturados com precisão e eficiência para verificação de identidade e outras aplicações seguras.

***

## **2. Quais são os requisitos do sistema para o SDK do Document Detector 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 26 e superior, garantindo compatibilidade com dispositivos Android modernos. Seu projeto Android deve usar uma **versão mínima do SDK de 26**.

**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/document-detector/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`)
  * Biblioteca Externa (`android.permission.READ_EXTERNAL_STORAGE`) **Somente para o recurso de upload.**
  * 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`)
  * Biblioteca Externa (`Privacidade - Descrição de Uso da Biblioteca de Fotos`) **Somente para o recurso de upload.**

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 SDK do Document Detector no 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-document-detector
   ```
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/document-detector/installation.md).

***

## **5. O SDK do Document Detector é compatível com o Expo?**

**Resposta:**

Sim, o Document Detector SDK pode ser usado com Expo, mas somente no [Bare Workflow](https://docs.expo.dev/more/glossary-of-terms/#bare-workflow), que permite as configurações nativas necessárias. Para configurar o SDK para o Expo, siga estas etapas:

* 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://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/document-detector/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/document-detector/current-version.md).

***

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

**Resposta:**

Para iniciar o detector de documentos, siga estas etapas:

1. Importe e use a `startDocumentDetector` função.
2. Inicie a atividade do detector de documentos.
3. Capture o resultado no `useDocumentDetector` 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/document-detector/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 o detector de documentos funcione.

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/document-detector/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/document-detector/faq_document_detector_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.
