Introdução

Bem vindo ao manual de integração do SDK de Reconhecimento facial da QI Tech em React Native! O módulo @qitech/react-native-caas 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 realizar a prova de vida (liveness) do seu cliente diretamente do seu aplicativo React Native e referenciar a imagem capturada, através de uma chave, nos demais produtos do sistema QI Tech.

Pacotes disponíveis

Pacote	Conteúdo	Quando usar
@qitech/react-native-caas	Reconhecimento facial, OCR e Scan de dispositivo	Quando você precisa de reconhecimento facial, OCR ou do fluxo completo de onboarding.
@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.

Aviso Importante!

Ambos os pacotes incluem o Scan de dispositivo. Não instale os dois — escolha apenas um.

Para o Reconhecimento facial, utilize o @qitech/react-native-caas.

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 primeiro parâmetro da função startFaceRecon. 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 client_session_key.

Aviso Importante!

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

Integração com Device Scan

O serviço de Reconhecimento facial realiza automaticamente uma chamada interna ao Device Scan. Por isso, o retorno de sucesso inclui o campo device_scan_session_id, que identifica a sessão de scan de dispositivo realizada internamente e pode ser utilizada de forma integrada em outros serviços do ecossistema 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 client_session_key e exemplo completo da chamada startFaceRecon.
4. O objeto FaceReconOptions — todos os parâmetros de customização.
5. Coletando os Retornos — estrutura de resposta e tratamento de erros.