> 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/document-detector/faq.md). # FAQ *** ## **1. O que é o Document Detector e qual é sua principal funcionalidade?** **Resposta:** Document Detector permite que os usuários capturem fotos autênticas e de alta qualidade de documentos enviados pelos próprios usuários para análise usando nossa API. Ele oferece suporte à captura e leitura de documentos tanto pelo modo câmera quanto pelo modo de upload. A ferramenta pode processar vários tipos de documentos, como documentos de identidade nacionais e passaportes internacionais. *** ## **2. Quais são os requisitos do sistema para o Document Detector no iOS?** **Resposta:** O SDK requer as seguintes configurações de iOS: | Informações de implantação | Versão | | -------------------------- | ------ | | **Alvo do iOS** | 13.0+ | | **Xcode** | 16.4+ | | **Swift** | 5.10+ | Certifique-se de que seu projeto esteja configurado para atender a esses requisitos antes de integrar o SDK. *** ## **3. Quais permissões são necessárias para usar o SDK?** **Resposta:** O SDK requer permissões específicas no arquivo do seu aplicativo **`info.plist`** arquivo: | **Permissão** | **Motivo** | **Obrigatório?** | | ----------------------------------------------------------- | ---------------------------------- | ---------------------------------------------- | | **`Privacidade - Descrição de Uso da Câmera`** | Para capturar fotos de documentos. | Não, necessário apenas para o fluxo da câmera. | | **`Privacidade - Descrição de Uso da Biblioteca de Fotos`** | Para acessar fotos na galeria. | Não, necessário apenas para o fluxo de upload. | Certifique-se de fornecer descrições adequadas para essas permissões para cumprir as diretrizes da App Store. *** ## **4. Como faço para integrar o Document Detector ao meu projeto iOS?** **Resposta:** Para integrar o SDK: 1. Instale o SDK usando **Gerenciador de Pacotes Swift** ou outro gerenciador de dependências. 2. Adicione as permissões necessárias no seu **`info.plist`** arquivo. 3. Importe o SDK no seu código e inicialize-o no ciclo de vida do app, normalmente dentro do `AppDelegate` ou `SceneDelegate`. Para detalhes de integração passo a passo, consulte o [Guia de Instalação](/caf-sdk/caf-sdk-pt-br/ios/standalone-modules/document-detector/installation.md). *** ## **5. Como inicio o processo de captura de documentos no meu app?** **Resposta:** Para iniciar o processo de captura de documentos: 1. Configure a sessão de captura do SDK usando seu builder. 2. Inicie o view controller de captura usando o método de navegação de sua preferência. 3. Trate o retorno do callback com os dados do documento capturado. Para mais detalhes de implementação, veja o [Guia de Captura de Documentos](/caf-sdk/caf-sdk-pt-br/ios/standalone-modules/document-detector/start-sdk.md). *** ## **6. O Document Detector oferece suporte ao envio de documentos em vez de usar a câmera?** **Resposta:** Sim, o SDK oferece suporte a dois modos de entrada de documento: * **Modo Câmera**: Capture documentos usando a câmera do dispositivo. * **Modo de upload**: Envie fotos existentes da biblioteca de fotos do dispositivo. Você pode configurar o modo preferido durante a configuração da sessão. Para uma implementação detalhada, veja o [Documentação do Modo de Upload](/caf-sdk/caf-sdk-pt-br/ios/standalone-modules/document-detector/builder/upload.md). *** ## **7. Quais são os problemas ou erros comuns e como posso solucioná-los?** **Resposta:** Alguns problemas comuns incluem: * **Permissão negada**: Certifique-se de que as permissões necessárias (`Câmera` ou `Biblioteca de Fotos`) estejam incluídas no `info.plist` arquivo e sejam concedidas pelo usuário. * **Falha na inicialização do SDK**: Verifique se o SDK foi inicializado corretamente e se as dependências atendem às versões exigidas. * **O app trava durante a captura**: Verifique a integração do view controller e teste em dispositivos iOS compatíveis. Para uma lista completa de erros e etapas de solução de problemas, consulte o [Guia de Solução de Problemas](/caf-sdk/caf-sdk-pt-br/ios/standalone-modules/document-detector/references.md#documentdetectorfailure). *** ## **8. Qual é a versão atual do SDK e onde posso encontrar atualizações?** **Resposta:** A versão do SDK é atualizada regularmente para incluir novos recursos e melhorias. Você pode encontrar os detalhes da versão mais recente, as notas de versão e as atualizações em [Notas de versão do SDK](/caf-sdk/caf-sdk-pt-br/ios/standalone-modules/document-detector/current-version.md). --- # 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/document-detector/faq.md?ask=&goal= ``` `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.