Introdução

Bem vindo ao manual de integração do Device Scan da QI Tech em React Native! O módulo @qitech/react-native-device-scan expõe, por meio de uma interface TypeScript, os SDKs nativos de Android (Java/Kotlin) e iOS (Swift) da QI Tech. Você deve utilizá-lo para coletar informações do celular e do comportamento do usuário em seu aplicativo e assim melhorar a assertividade das decisões.

Pacotes disponíveis

Pacote	Conteúdo	Quando usar
@qitech/react-native-device-scan	Somente Scan de dispositivo	Quando você precisa apenas de scan de dispositivo — instalação mais leve, com menos dependências nativas.
@qitech/react-native-caas	Reconhecimento facial, OCR e Scan de dispositivo	Quando você também precisa de reconhecimento facial ou OCR.

Aviso Importante!

Ambos os pacotes incluem o Scan de dispositivo e expõem a mesma função startDeviceScan, com a mesma assinatura. Não instale os dois — escolha apenas um.

Esta seção documenta o @qitech/react-native-device-scan. Se o seu aplicativo já utiliza o @qitech/react-native-caas, basta trocar o caminho do import — todo o restante desta documentação se aplica sem alterações.

Problemas?

Nós não somos uma companhia que se esconde atrás de uma API! Entre em contato com o nosso suporte e nós responderemos o mais rápido possível. Fique à vontade para nos ligar caso deseje uma resposta rápida!

Adoramos Feedback

Mesmo que você já tenha resolvido o seu problema ou que ele seja muito simples (Até mesmo um typo ou uma organização inadequada que você já entendeu), envie-nos um e-mail, assim nós tornamos a documentação cada vez mais prática e a próxima pessoa não vai precisar sofrer as dores que você sofreu!

Ambientes

Possuímos dois ambientes para os nossos clientes. A seleção é realizada por meio do enumerador CAAS_ENVIRONMENT, repassado como último parâmetro da função startDeviceScan. No momento, os seguintes ambientes estão disponíveis:

• Produção - CAAS_ENVIRONMENT.PRODUCTION
• Sandbox - CAAS_ENVIRONMENT.SANDBOX

Cada ambiente exige uma API Key diferente para a geração do token.

Aviso Importante!

Não devem ser usados dados reais de pessoas físicas e/ou jurídicas nos ambientes de Sandbox da QI Tech.

Próximos passos

1. Compatibilidade — versões mínimas de React Native, iOS e Android.
2. Instalação — instalação do pacote e configuração nativa de Android, iOS e Expo.
3. Implementação — obtenção do token e exemplo completo da chamada startDeviceScan.
4. A função startDeviceScan — parâmetros e retorno.
5. Permissões — permissões que ampliam a coleta de dados.