# QI Tech — Risk Solutions › Scan de dispositivo Documentação da QI Tech em texto corrido, para colar em um LLM. Fonte: https://docs.qitech.com.br 31 página(s). Índice: - O objeto DeviceScan (/documentation/caas/device_scan/android/device_scan_object) - Implementação (/documentation/caas/device_scan/android/example) - Coleta de informações (/documentation/caas/device_scan/android/information_gathering) - Introdução (/documentation/caas/device_scan/android/introduction) - Integração nativa (/documentation/caas/device_scan/android/native_java) - Permissões (/documentation/caas/device_scan/android/permissions) - Autenticação (/documentation/caas/device_scan/api/authentication) - Compatibilidade da Biblioteca (/documentation/caas/device_scan/flutter/compatibility) - O objeto QitechDeviceScan (/documentation/caas/device_scan/flutter/device_scan_object) - Implementação (/documentation/caas/device_scan/flutter/example) - Instalação (/documentation/caas/device_scan/flutter/installation) - Introdução (/documentation/caas/device_scan/flutter/introduction) - Permissões (/documentation/caas/device_scan/flutter/permissions) - O objeto QITechIosDeviceScan (/documentation/caas/device_scan/ios/device_scan_object) - Implementação (/documentation/caas/device_scan/ios/example) - Coleta de informações (/documentation/caas/device_scan/ios/information_gathering) - Introdução (/documentation/caas/device_scan/ios/introduction) - Integração nativa (/documentation/caas/device_scan/ios/native_swift) - Permissões (/documentation/caas/device_scan/ios/permissions) - Compatibilidade (/documentation/caas/device_scan/react_native/compatibility) - A função startDeviceScan (/documentation/caas/device_scan/react_native/device_scan_object) - Implementação (/documentation/caas/device_scan/react_native/example) - Instalação (/documentation/caas/device_scan/react_native/installation) - Introdução (/documentation/caas/device_scan/react_native/introduction) - Permissões (/documentation/caas/device_scan/react_native/permissions) - Desktop Device Scan (/documentation/caas/device_scan/web/desktop) - O objeto DeviceScan (/documentation/caas/device_scan/web/device_scan_object) - Implementação (/documentation/caas/device_scan/web/example) - Importando a biblioteca (/documentation/caas/device_scan/web/import) - Coletando os Retornos (/documentation/caas/device_scan/web/information_gathering) - Introdução (/documentation/caas/device_scan/web/introduction) --- # O objeto DeviceScan URL: /documentation/caas/device_scan/android/device_scan_object Para utilizar a DeviceScanSDK, é necessário instanciar a classe DeviceScan. Essa instância recebe o currentContext e pode ser configurada com token/sessão, ambiente e callback (notifier). :::danger Aviso Importante! A partir da versão 5.0.0, o sistema de autenticação foi atualizado para usar um **token** temporário no lugar do **mobileToken**. ::: ## Versão 5.0.0+ | Parâmetro | Função | Obrigatório | |------------|--------------|--------------| |currentContext|Contexto da aplicação, utilizado no acesso a dados necessários. |Sim.| |token (via .setToken(this.token))| Token de autenticação que identifica que os dados coletados são provenientes do seu aplicativo. O token é obtido por meio de requisição à API da Device Scan. |Sim.| |sessionId (via .setSessionId(this.sessionId))|Identificador da sessão de onde os dados coletados são provenientes.|Sim.| |notifier (via .setNotifier(this.deviceScanNotifier))|Instância de DeviceScanNotifier. Atua como callback, retornando a situação do envio (sucesso ou falha). |Não.| |sandbox (via .setSandboxEnvironment())|Configura a biblioteca para enviar dados ao ambiente `sandbox`. Se não configurado, as requisições são enviadas para `production`. |Não.| **Ambiente padrão**: caso `setSandboxEnvironment()` não seja chamado, o envio é feito para `production`. ## Versões Anteriores (até 4.x) | Parâmetro | Função | Obrigatório | |------------|--------------|--------------| |currentContext|Contexto da aplicação, utilizado no acesso a dados necessários.|Sim.| |mobileToken (via .setMobileToken(this.mobileToken))|Chave do cliente que identifica que os dados coletados são provenientes do seu aplicativo. Caso ainda não tenha recebido o seu **mobile-token**, entre em contato com o suporte: suporte.caas@qitech.com.br.|Sim.| |sessionId (via .setSessionId(this.sessionId))|Identificador da sessão de onde os dados coletados são provenientes.|Sim.| |notifier (via .setNotifier(this.deviceScanNotifier))|Instância de DeviceScanNotifier. Atua como callback, retornando a situação do envio (sucesso ou falha).|Não.| |sandbox (via .setSandboxEnvironment())|Configura a biblioteca para enviar dados ao ambiente `sandbox`. Se não configurado, as requisições são enviadas para `production`. |Não.| ## Resumo Rápido (Migração) - 5.0.0+: usar `token` temporário (`setToken(this.token)`) - < 5.0.0: usar `mobileToken` (`setMobileToken(this.mobileToken)`) - Em ambas: `currentContext` e `sessionId` são obrigatórios. `notifier` e `sandbox` são opcionais. --- # Implementação URL: /documentation/caas/device_scan/android/example :::danger Aviso Importante! A partir da versão 5.0.0, o sistema de autenticação foi atualizado para usar um **token** dinâmico em vez de **mobileToken**. Antes de configurar o SDK, você deve gerar um **token** temporário através de uma requisição server-to-server para a nossa API de Device Scan. ::: ```java package com.example.zaig_device_scan_sdk_test_app; import androidx.appcompat.app.AppCompatActivity; import android.os.Bundle; import android.util.Log; import android.view.View; import com.qitech.android.devicescan.DeviceScan; import com.qitech.android.devicescan.DeviceScanNotifier; import java.util.ArrayList; public class MainActivity extends AppCompatActivity { private DeviceScan deviceScan; private DeviceScanNotifier deviceScanNotifier; @Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.activity_main); deviceScanNotifier = new DeviceScanNotifier(this); } public void sendDeviceScan(View view) { try{ deviceScan = new DeviceScan.Builder(this.getApplicationContext()) .setToken(this.token) .setSessionId(this.sessionId) .setNotifier(this.deviceScanNotifier) .setSandboxEnvironment() .build(); }catch (Exception ex) { Log.e("DeviceScan Error", "There was an error collecting DeviceScan data: " + ex.toString()); } } @Override public void onRequestPermissionsResult(int requestCode, String[] permissions, int[] grantResults){ try{ deviceScan.collectData(this.documentNumber, this.eventId, this.eventType); }catch (Exception ex) { Log.e("DeviceScan Error", "There was an error collecting DeviceScan data: " + ex.toString()); } } private class ScanNotifier implements DeviceScanNotifier { AppCompatActivity activity; public ScanNotifier (AppCompatActivity myActivity){ // Este método é customizável e pode ser utilizado para se armazenar a Activity, utilizada para operar a UI this.activity = myActivity; } public void onSuccess(){ Log.i("DeviceScan", "DeviceScan successfully submitted"); runOnUiThread(new Runnable() { @Override public void run() { // Adicionar aqui quaisquer mudanças de UI que sejam necessárias após o envio com sucesso do device scan } }); } public void onError(){ Log.i("DeviceScan", "DeviceScan submission failed"); runOnUiThread(new Runnable() { @Override public void run() { // Adicionar aqui quaisquer mudanças de UI que sejam necessárias após o envio com sucesso do device scan } }); } } } ``` Para utilizar o SDK do device scan android, os seguintes passos são necessários: * Inserir as autorizações ao manifest da aplicação; * Importar a biblioteca ao projeto da aplicação; * Ao iniciar a aplicação, instanciar a biblioteca, passando os parâmetros adequados em seu construtor, incluindo o Notifier, responsável por dar o CallBack da operação com o resultado; * Utilizar a função `onRequestPermissionsResult` da Activity para ser notificado do resultado da aprovação ou não das permissões requeridas; * Requisitar as permissões ao usuário. É obrigatória a permissão de acesso a internet para o funcionamento da biblioteca; * Ao ser notificado do resultado da aprovação ou não das permissões, colete e envie os dados por meio do método `collectData`. --- # Coleta de informações URL: /documentation/caas/device_scan/android/information_gathering Para disparar a coleta e o envio de informações, é necessário (após obter as permissões do usuário) chamar o método `collectData`. O método, além de capturar as informações do dispositivo, tem como objetivo mapear a jornada do cliente dentro da aplicação. Por esse motivo, o método também aceita os campos `eventId` e `eventType`. O método possui os seguintes parâmetros: nome | tipo | descrição ---- | ---- | --------- documentNumber | String | O número do documento do usuário, caso disponível. (CPF/CNPJ sem pontos, traços e barra) eventId | String | Um identificador do evento que está sendo reportado eventType | String | Um valor enumerado que define o tipo de evento que está sendo reportado. Recomenda-se cuidado para que eventos muito similares sejam reportados com o mesmo enumerador, a fim de que inteligência possa ser construída sobre esses dados. Após a chamada de coleta dos dados, um dos dois métodos da instância de `DeviceScanNotifier` passada no construtor da classe `DeviceScan` será chamado: `onSuccess` caso tudo corra conforme o esperado ou `onError`, em caso de erro. --- # Introdução URL: /documentation/caas/device_scan/android/introduction Bem-vindo(a) ao manual de integração do Device Scan Android da QI Tech! Você deve utilizar nosso SDK para coletar informações do dispositivo e do comportamento do usuário no seu aplicativo e, assim, aumentar a assertividade das decisões. ## Problemas? Não somos uma companhia que se esconde atrás de uma API. Entre em contato com o nosso [suporte](mailto:suporte.caas@qitech.com.br) e responderemos o mais rápido possível. Fique à vontade para nos ligar caso precise de uma resposta mais rápida! ### Adoramos Feedback Mesmo que você já tenha resolvido o problema ou que ele seja muito simples (como um erro de digitação ou uma organização inadequada), envie-nos um e-mail. Assim, tornamos a documentação cada vez mais prática, e a próxima pessoa não precisa passar pelas mesmas dores. ## Ambientes Disponibilizamos dois ambientes para os nossos clientes. A seleção é realizada por meio de um enumerador informado no construtor do SDK. No momento, os seguintes ambientes estão disponíveis: * Produção - `production` * Sandbox - `sandbox` :::danger Aviso Importante! Não devem ser usados dados reais de pessoas físicas e/ou jurídicas no ambiente de Sandbox da QI Tech. ::: --- # Integração nativa URL: /documentation/caas/device_scan/android/native_java Para importar nossos SDKs, é necessário realizar alterações nos arquivos build.gradle do projeto e do aplicativo. ## Adicionando ao Projeto Adicione o endereço do nosso repositório Maven no build.gradle do projeto (no Android Studio, este arquivo aparece como “Project: \{nome_do_projeto\}”), conforme o exemplo abaixo: ```java buildscript { ... } allprojects { repositories { ... maven { url 'https://sdks.qitech.com.br/' } } } ``` ## Adicionando ao Aplicativo Em seguida, adicione a biblioteca que você pretende importar no build.gradle do app (no Android Studio, este arquivo aparece como **“Module: \{nome_do_projeto\}.app”**), incluindo a dependência abaixo: ```java dependencies { ... implementation 'com.qitech.android:devicescan:v6.0.0' } ``` :::warning Desde **abril de 2025**,** novas políticas da Google Play exigem **Android API Level 35** para que aplicativos possam ser publicados ou atualizados na Google Play Store. Por isso, recomendamos fortemente que você utilize **targetSdkVersion 35**, no mínimo. ::: :::info A utilização de **targetSdkVersion 35** implica na utilização do **compileSdkVersion 35**, o que acarreta alguns **requisitos mínimos** para ferramentas do ecossistema do Android: * compileSdkVersion 35 --> AGP 8.6.0 * AGP 8.6.0 --> Gradle 8.7 * AGP 8.6.0 --> Java 17 (JDK 17) * AGP 8.6.0 --> Kotlin 2+ ::: ## Arquivo Manifest Para utilizar o SDK, você deve adicionar a seguinte configuração ao AndroidManifest da sua aplicação: ```java ``` Você também deve adicionar, no mínimo, a permissão de internet, que é utilizada para enviar os dados coletados aos servidores da QI Tech: ` ` A lista de permissões deverá ser ajustada de acordo com a necessidade. --- # Permissões URL: /documentation/caas/device_scan/android/permissions O SDK coleta dados do dispositivo do usuário de acordo com as permissões disponíveis no momento da coleta: quanto mais permissões o seu aplicativo solicitar e o usuário conceder, mais informações poderão ser coletadas. :::info **Atenção** A permissão INTERNET é obrigatória para que o SDK consiga enviar as informações aos servidores da QI Tech. ::: ## Permissões utilizadas pelo SDK Na versão atual do SDK, as permissões abaixo podem ser utilizadas, caso estejam disponíveis: | Permissão | Função | Obrigatória | |------------|--------------|--------------| |INTERNET|Envio das informações aos servidores da QI Tech.| Sim. | |BLUETOOTH|Captura de informações do hardware de Bluetooth.| Não. | |BLUETOOTH_CONNECT|Captura de informações de conexão Bluetooth.| Não. | |READ_CONTACTS|Leitura da agenda de contatos.| Não. | |ACCESS_COARSE_LOCATION|Acesso a informações de rede (Antena, operadora, etc) e à localização por este meio (menos precisa).| Não. | |ACCESS_FINE_LOCATION|Acesso à localização por meio de GPS (mais precisa).| Não. | |READ_PHONE_STATE|Informações de Rede, SIM, Imei e outros aspectos de telefonia.| Não. | |QUERY_ALL_PACKAGES|Informações de aplicativos instalados no dispositivo. Necessária para devices Android 11 em diante.| Não. | :::info **Importante** Nosso SDK não solicita as permissões descritas. Portanto, para garantir um device scan mais completo, recomendamos solicitar e obter essas permissões antes de executar a chamada do device scan. ::: :::info **Atenção** A permissão QUERY_ALL_PACKAGES pode gerar atrito com o Google Play no momento do lançamento do app. Para contornar esse ponto, é possível descrever o motivo da solicitação dessa permissão. ::: --- # Autenticação URL: /documentation/caas/device_scan/api/authentication :::danger Aviso Importante! A partir da versão 5.0.0 dos SDKs de iOS e Android, o sistema de autenticação foi atualizado para usar um token temporário em vez do mobileToken. ::: Utilizamos uma API Key para permitir o acesso à nossa API. Normalmente, essa chave é enviada por e-mail. Caso você ainda não tenha recebido a sua, envie uma mensagem para suporte.caas@qitech.com.br . ## Token temporário de autenticação Antes de configurar o SDK, você deve gerar um token temporário por meio de uma requisição server-to-server para a nossa API. ### Gerar token ```bash curl -X POST "https://d.viewpkg.com/device_scan/token" \ -H "Authorization: EXAMPLE_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "session_id": "unique_session_identifier" }' ``` **Endpoints** | Ambiente | URL | |----------|-----| | Sandbox | https://d.sandbox.viewpkg.com/device_scan/token | | Produção | https://d.viewpkg.com/device_scan/token | **Detalhes da Requisição** | Campo | Tipo | Obrigatório | Descrição| |-------|------|------------|---------| | session_id | string | Sim | Identificador único da sessão gerado pelo seu sistema (por exemplo, UUID). | **Request Body** ```json { "session_id": "unique_session_identifier" } ``` **Response Body** A resposta bem-sucedida conterá o campo `token`. ```json { "token": "eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6..." } ``` :::info Atenção Substitua `EXAMPLE_API_KEY` pela API Key recebida do suporte. ::: --- # Compatibilidade da Biblioteca URL: /documentation/caas/device_scan/flutter/compatibility | Configuração | Versão mínima | |------------|--------------| |Flutter|3.3.0| |Dart SDK|3.2.3| |iOS|15.5| |minSdkVersion (Android)|23| |Datadog SDK nativo (iOS, trazido pelo plugin)|3.x| --- # O objeto QitechDeviceScan URL: /documentation/caas/device_scan/flutter/device_scan_object :::danger Aviso Importante! A partir da versão 1.0.0, o sistema de autenticação foi atualizado para usar um **token** temporário no lugar do **mobileToken**. O token é obtido por meio de requisição server-to-server à API da Device Scan. ::: ## Chamada Para utilizar o plugin de Device Scan, é necessário realizar a chamada do método `startDeviceScan` que possui os seguintes parâmetros: ## Versão 1.0.0+ | Parâmetro | Tipo | Função | Obrigatório | |------------|--------------|--------------|--------------| |token|String|Token de autenticação temporário obtido por meio de requisição à API da Device Scan. Deve ser gerado com o mesmo `sessionId` passado a este método.|Sim.| |environment|CaaSEnvironment|Enumerador utilizado para configurar o ambiente de execução para `sandbox` ou `production`. |Sim.| |sessionId|String|Chave que identifica a sessão da qual os dados coletados são provenientes. **Deve ser enviado em letras minúsculas.**|Sim.| |eventType|String|Um enumerador que define o tipo de evento sendo reportado - É pedido cuidado para que eventos muito similares seja reportados com o mesmo enumerador, a fim de que inteligência possa ser construída sobre esses dados.|Sim.| |eventId|String|Um identificador do evento sendo reportado|Sim.| |documentNumber|String?|O número do documento do usuário, caso disponível. (CPF/ CNPJ sem pontos, traços e barra). Pode ser omitido.|Não.| ## Versões Anteriores (até 0.x) | Parâmetro | Tipo | Função | Obrigatório | |------------|--------------|--------------|--------------| |mobileToken|String|Chave do cliente que identifica que os dados coletados são provenientes do seu aplicativo. Caso ainda não tenha recebido o seu mobile-token, entre em contato com o suporte.|Sim.| |environment|CaaSEnvironment|Enumerador utilizado para configurar o ambiente de execução para `sandbox` ou `production`. |Sim.| |sessionId|String|Chave que identifica a sessão da qual os dados coletados são provenientes. **Deve ser enviado em letras minúsculas.**|Sim.| |eventType|String|Um enumerador que define o tipo de evento sendo reportado - É pedido cuidado para que eventos muito similares seja reportados com o mesmo enumerador, a fim de que inteligência possa ser construída sobre esses dados.|Sim.| |eventId|String|Um identificador do evento sendo reportado|Sim.| |documentNumber|String?|O número do documento do usuário, caso disponível. (CPF/ CNPJ sem pontos, traços e barra). Pode ser omitido.|Não.| ## Resumo Rápido (Migração) - 1.0.0+: usar `token` temporário obtido via API (`token: token`) - '`) - Em ambas: `environment`, `sessionId`, `eventType` e `eventId` são obrigatórios. `documentNumber` é opcional. ## Migração para a 2.0.0 - `pubspec.yaml`: `qitech_device_scan: ^2.0.0`. O código Dart não muda. - iOS: `source 'https://github.com/QITechSDKs/iOS.git'` no `Podfile`. O SDK nativo passa a exigir Datadog 3.x (`datadog_flutter_plugin` 3.x, se utilizado). - Android: repositório Maven `https://sdks.qitech.com.br/` no `build.gradle`. ## Retorno O método retorna uma String para indicar sucesso ou falha durante a coleta das informações: ### Sucesso ```javascript Success collecting device scan data ``` ### Erro ```javascript Device Scan fail. Check token, environment and permissions ``` --- # Implementação URL: /documentation/caas/device_scan/flutter/example Antes de executar o exemplo abaixo, instale o plugin e aplique as configurações nativas de Android e iOS descritas em [Instalação](/documentation/caas/device_scan/flutter/installation). ## Pré-requisito para startDeviceScan O método `startDeviceScan` requer um `token`. Este token é temporário e deve ser gerado no seu backend por meio de uma requisição server-to-server para a nossa API antes de chamar o método do SDK. **Detalhes do Endpoint:** - **Método:** POST - **Path:** `/device_scan/token` - **Sandbox URL:** `https://d.sandbox.viewpkg.com/device_scan/token` - **Production URL:** `https://d.viewpkg.com/device_scan/token` **Headers:** ```json { "Authorization": "YOUR_DEVICE_SCAN_API_KEY" } ``` **Body:** ```json { "session_id": "unique_session_id" } ``` A resposta bem-sucedida desta API conterá o `token` que você deve repassar ao método `startDeviceScan`. :::note O método de device scan pode ser executado de forma assíncrona. Portanto, não é necessário bloquear a thread principal para aguardar a resolução deste método. O usuário pode interagir normalmente com o app enquanto o device scan é processado em segundo plano. ::: :::note Recomendamos que o método de device scan seja executado o mais cedo possível. Como ele pode precisar de mais tempo de execução para coletar todos os dados, esta chamada antecipada é recomendada para que as informações mais completas do dispositivo sejam extraídas. ::: --- ```dart import 'dart:convert'; import 'dart:io'; import 'package:http/http.dart' as http; import 'package:qitech_device_scan/qitech_device_scan.dart'; final _qitechDeviceScanPlugin = QitechDeviceScan(); // Etapa 1: Gerar o token temporário via requisição server-to-server Future fetchDeviceScanToken(String sessionId) async { final response = await http.post( Uri.parse(''), headers: { HttpHeaders.authorizationHeader: '', HttpHeaders.contentTypeHeader: 'application/json', }, body: jsonEncode({'session_id': sessionId}), ); if (response.statusCode == 200) { final data = jsonDecode(response.body); return data['token'] as String?; } return null; } // Etapa 2: Inicializar o SDK com o token obtido final sessionId = ''; final token = await fetchDeviceScanToken(sessionId); if (token == null) { print('Failed to fetch device scan token'); return; } final result = await _qitechDeviceScanPlugin.startDeviceScan( token: token, environment: CaaSEnvironment.sandbox, sessionId: sessionId, eventType: '', eventId: '', ); print('Device Scan result: $result'); ``` --- # Instalação URL: /documentation/caas/device_scan/flutter/installation ## Instalando o plugin Execute o comando abaixo na raiz do seu projeto Flutter: ```bash flutter pub add qitech_device_scan ``` O comando instala a versão mais recente e adiciona a dependência ao seu `pubspec.yaml`: ```yaml dependencies: qitech_device_scan: ^2.0.0 ``` ## Importação ```dart import 'package:qitech_device_scan/qitech_device_scan.dart'; ``` E instancie o plugin: ```dart final _qitechDeviceScanPlugin = QitechDeviceScan(); ``` ## Configuração do Android ### 1. Repositório Maven da QI Tech Adicione a referência do repositório Android da QI Tech no seu arquivo `build.gradle`: ```gradle allprojects { repositories { maven { url 'https://sdks.qitech.com.br/' } ... } } ``` ### 2. AdMob Inicialize o serviço de AdMob ao adicionar o seguinte código em seu `AndroidManifest.xml`: ```xml ``` Caso não possua um `ADMOB_APP_ID`, entre em contato com o suporte.caas@qitech.com.br . ### 3. Permissões Declare no `AndroidManifest.xml` as permissões que deseja disponibilizar ao SDK. Veja [Permissões](/documentation/caas/device_scan/flutter/permissions) para a lista completa. ## Configuração do iOS ### 1. Source do repositório iOS da QI Tech Adicione a referência do repositório iOS da QI Tech em seu arquivo `Podfile`: ```ruby source 'https://cdn.cocoapods.org/' source 'https://github.com/QITechSDKs/iOS.git' ``` ### 2. Permissões Declare no `Info.plist` as permissões que deseja disponibilizar ao SDK. Veja [Permissões](/documentation/caas/device_scan/flutter/permissions). ### 3. Instalação das dependências Instale as dependências diretamente através do CocoaPods: ```bash cd ios pod install ``` ou através do Flutter: ```bash flutter build ios ``` :::warning Atenção A partir da versão **2.0.0**, o SDK nativo de iOS exige o Datadog `3.x`. Se o seu aplicativo já utiliza o `datadog_flutter_plugin`, use a versão mais recente dentro do major `3.x`. ::: --- # Introdução URL: /documentation/caas/device_scan/flutter/introduction Bem vindo ao manual de integração da Device Scan da QI Tech em Flutter! Você deve utilizar o nosso Plugin para coletar informações do celular e do comportamento do usuário em seu aplicativo e assim melhorar a assertividade das decisões. ## Plugins disponíveis | Plugin | Conteúdo | Quando usar | |--------|----------|-------------| |`qitech_device_scan`|Somente Scan de dispositivo|Quando você precisa **apenas** de scan de dispositivo — instalação mais leve, com menos dependências nativas.| |`flutter_kyc_qitech`|Reconhecimento facial, OCR e Scan de dispositivo|Quando você também precisa de reconhecimento facial ou OCR.| :::danger Aviso Importante! Ambos os plugins incluem o Scan de dispositivo. **Não instale os dois** — escolha apenas um. ::: Esta seção documenta o `qitech_device_scan`. Se o seu aplicativo utiliza o `flutter_kyc_qitech`, consulte a seção [Flutter do Reconhecimento facial](/documentation/caas/face_recognition/flutter/introduction) ou [Flutter do OCR](/documentation/caas/ocr/flutter/introduction) — naquele plugin, o método `startDeviceScan` recebe parâmetros posicionais em vez de nomeados. ## Problemas? Nós não somos uma companhia que se esconde atrás de uma API! Entre em contato com o nosso [suporte](mailto:suporte.caas@qitech.com.br) 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 de enumerador repassado no parâmetro da chamada do plugin, no momento, os seguintes ambientes estão disponíveis: * Produção - `production` * Sandbox - `sandbox` :::danger Aviso Importante! Não devem ser usados dados reais de pessoas físicas e/ou jurídicas nos ambientes de Sandbox da QI Tech. ::: --- # Permissões URL: /documentation/caas/device_scan/flutter/permissions O plugin coleta dados do dispositivo do usuário conforme as permissões que estão disponíveis no momento da coleta: conforme mais permissões seu aplicativo requerir e o usuário disponibilizar, mais informações são coletadas do dispositivo do usuário. :::info **Atenção** A permissão de INTERNET é obrigatória para que o SDK consiga enviar as informações aos servidores da QI Tech. ::: ## Permissões utilizadas pelo plugin :::info **Importante** Nosso plugin não solicita as permissões descritas. Portanto, para garantir um scan de dipositivo mais completo, recomendamos a coleta dessas permissões antes de executar a chamada da device scan. ::: ### Android Para a plataforma android, as seguintes permissões são utilizadas caso estejam disponíveis: | Permissão | Função | Obrigatória | |------------|--------------|--------------| |INTERNET|Obrigatória, para envio das informações aos servidores da QI Tech.| Sim. | |BLUETOOTH|Captura de informações do hardware de Bluetooth.| Não. | |BLUETOOTH_CONNECT|Captura de informações de conexão Bluetooth.| Não. | |READ_CONTACTS|Leitura da agenda de contatos.| Não. | |ACCESS_COARSE_LOCATION|Acesso a informações de rede (Antena, operadora...) e à localização por este meio (Menos preciso).| Não. | |ACCESS_FINE_LOCATION|Acesso à localização por meio de GPS (Mais preciso).| Não. | |READ_PHONE_STATE|Informações de Rede, SIM, Imei e outros aspectos de telefonia.| Não. | |QUERY_ALL_PACKAGES|Informações de aplicativos instalados no dispositivo. Necessária para devices Android 11 em diante.| Não. | :::info **Atenção** A permissão de QUERY_ALL_PACKAGES pode gerar atrito com o Google Play no momento do lançamento do App. Para solucioná-lo é possível descrever o motivo da solicitação da permissão. ::: ### iOS Para a plataforma iOS, as seguintes permissões são utilizadas caso estejam disponíveis: * location - Captura de dados de geolocalização do device #### Arquivo Info.plist O primeiro passo para disponibilizar permissões para o plugin é configurar a permissão no arquivo Info.plist da aplicação, utilizando a seguinte linha de código para cada uma das permissões desejadas: * location - Captura de dados de geolocalização do device: ` NSLocationWhenInUseUsageDescription ` ` Adicionar a mensagem que você deseja que apareça para o usuário quando o iOS solicitar a permissão de acesso à geolocalização ` :::info **Atenção** Para melhorar a experiência do usuário no momento da solicitação das permissões você deve personalizar a mensagem reproduzida no pop-up de solicitação conforme descrito anteriormente. ::: --- # O objeto QITechIosDeviceScan URL: /documentation/caas/device_scan/ios/device_scan_object Para utilizar o DeviceScan iOS da QI Tech, é necessário importar o framework QITechIosDeviceScan e então instanciar a classe QITechIosDeviceScan que possui os seguintes parâmetros no construtor: :::danger Aviso Importante! A partir da versão 5.0.0, o sistema de autenticação foi atualizado para usar um **token** temporário em vez de **mobileToken**. ::: ## Versão 5.0.0+ nome | tipo | descrição ---- | ----- | ------ environment | String | Um enumerador do ambiente onde a aplicação está sendo executada - `sandbox` ou `production` - caso um valor diferente seja enviado, uma exceção será gerada **obrigatório** token | String | Token de autenticação que identifica que os dados coletados são provenientes do seu aplicativo. Obtida através de requisição à API da Device Scan. **obrigatório** sessionId | String | O identificador da sessão (**Deve ser o mesmo utilizado para gerar o token**), que será enviado também no momento da avaliação do evento (Transação, Onboarding, por exemplo), para cruzamento entre os dados do device scan e o evento a ser avaliado. **obrigatório** ## Versões Anteriores nome | tipo | descrição ---- | ----- | ------ environment | String | Um enumerador do ambiente onde a aplicação está sendo executada - `sandbox` ou `production` - caso um valor diferente seja enviado, uma exceção será gerada **obrigatório** mobileToken | String | A chave de cliente enviada pelo suporte da QI Tech e que identifica que os dados coletados são provenientes do seu aplicativo. Por questões de segurança, caso esta chave esteja incorreta, os servidores da QI Tech recebem mas não processam a chamada. **obrigatório** sessionId | String | O identificador da sessão, que será enviado também no momento da avaliação do evento (Transação, Onboarding, por exemplo), para cruzamento entre os dados do device scan e o evento a ser avaliado. **obrigatório** --- # Implementação URL: /documentation/caas/device_scan/ios/example :::danger Aviso Importante! A partir da versão 5.0.0, o sistema de autenticação foi atualizado para usar um **token** dinâmico em vez de **mobileToken**. Antes de configurar o SDK, você deve gerar um **token** temporário através de uma requisição server-to-server para a nossa API de Device Scan. ::: ```swift import UIKit import QITechIosDeviceScan class ViewController: UIViewController { var qitechDeviceScan : QITechIosDeviceScan? override func viewDidLoad() { super.viewDidLoad() self.setupDeviceScan() } func setupDeviceScan() -> Void { // The environment can be 'sandbox' ou 'production' let environment = "sandbox" // MobileToken is the key sent to you by QI Tech. Each environment requires a different MobileToken. let token = "TEMPORARY_TOKEN_FROM_DEVICE_SCAN_API" // You must send the same session id in the moment of using the device scan and event analysis. It must be a key that uniquely identifies each user session in the app let sessionId = "62715840-068a-4ded-a4e2-a1ec83f857d4" do{ self.qitechDeviceScan = try QITechIosDeviceScan(environment: environment, token: token, sessionId: sessionId) } catch{ print ("Error found when instantiating QITech's DeviceScan") } let permissions = ["location"] do{ try self.qitechDeviceScan?.requestPermissions(permissions: permissions) } catch{ print ("Error found when requesting QITech's DeviceScan's permissions") } } func onSuccess() { // Do something if QI Tech DeviceScan's collectData method succesfully collected device data } func onError() { // Do something if QI Tech DeviceScan's collectData method found any error when collecting device data } func collectQITechDeviceScanData() { // If you have your customer's document number (CPF or CNPJ without dots, hyphen or slash), you must sent it to QI Tech let documentNumber = "12345678900" // EventType must represent with type of interation the user had with your app on the moment that collectData method was called let eventType = "login" // EventId is your code that identifies the event sent to QI Tech let eventId = "7038632032" do{ try self.qitechDeviceScan?.collectData(documentNumber: documentNumber, eventId: eventId, eventType: eventType, onSuccessHandler: self.onSuccess, onErrorHandler: self.onError) } catch{ print("Error found when collecting QITech's DeviceScan data") } } } ``` Para utilizar o SDK do Device Scan iOS, os seguintes passos são necessários: Inserir as autorizações no arquivo Info.plist Adicionar o framework ao projeto do aplicativo Ao iniciar a aplicação, instanciar a biblioteca, passando os parâmetros adequados Caso sua aplicação ainda não tenha solicitado as permissões ao usuário, requisitar as permissões ao usuário por meio da função `requestPermissions` do objeto previamente instanciado Coletar e enviar os dados por meio do método `collectData` --- # Coleta de informações URL: /documentation/caas/device_scan/ios/information_gathering Para disparar a coleta e o envio de informações, é necessário chamar o método `collectData`. O método, além de capturar as informações do dispositivo, tem como objetivo mapear a jornada do cliente dentro da aplicação. É por esta razão que o método também aceita os campos `eventId` e `eventType`. Outro ponto importante é que o método envia as informações para o servidor da QI Tech via request http assíncrono, e para isso, a notificação de sucesso ou erro da requisição é feita através de Completion Handlers. O método possui os seguintes parâmetros: nome | tipo | descrição ---- | ---- | --------- documentNumber | String | O número do documento do usuário, caso disponível. (CPF/ CNPJ sem pontos, traços e barra) eventId | String | Um identificador do evento sendo reportado eventType | String | Um enumerador que define o tipo de evento sendo reportado (Exemplo: 'login') - Cuidado para que eventos muito similares sejam reportados com o mesmo enumerador, a fim de que inteligência possa ser construída sobre esses dados onSuccessHandler | func() ‑> Void | Função que será chamada no caso de sucesso no envio dos dados para o servidor da QI Tech **obrigatório** onErrorHandler | func() ‑> Void | Função que será chamada no caso de erro no envio dos dados para o servidor da QI Tech **obrigatório** --- # Introdução URL: /documentation/caas/device_scan/ios/introduction Bem vindo ao manual de integração do Device Scan iOS da QI Tech! Você deve utilizar o nosso Framework para coletar informações do celular e do comportamento do usuário em seu aplicativo e assim melhorar a assertividade das decisões. ## Problemas? Nós não somos uma companhia que se esconde atrás de uma API! Entre em contato com o nosso [suporte](mailto:suporte.caas@qitech.com.br) 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 de enumerador repassado no construtor da classe QITechIosDeviceScan, no momento, os seguintes ambientes estão disponíveis: * Produção - `production` * Sandbox - `sandbox` :::danger 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 nativa URL: /documentation/caas/device_scan/ios/native_swift ## Remotamente > Iniciando a instalação ```shell pod init ``` Nosso SDK pode ser importado utilizando CocoaPods. SDK | Versão atual ---- | ----- QITechIosDeviceScan | `pod 'QITechIosDeviceScan', '~> 6.0.0'` :::info iOS Minimum Deployment Target 15.5 ::: Para iniciar a instalação, execute o comando ao lado na pasta raiz do seu projeto. > Adicionando a source na podfile ```ruby source 'https://github.com/QITechSDKs/iOS.git' ``` O próximo passo é adicionar no arquivo `podfile` o source da QI Tech. > Adicionando o pod na podfile ```ruby pod 'QITechIosDeviceScan', '~> ' ``` Por fim, basta adicionar o nome do `pod` de acordo com o formato acima. :::danger Atenção: Mudança de Arquitetura (v5.0.0+) A partir da versão 5.0.0, o SDK passou a ser distribuída exclusivamente de forma estática. No seu Podfile, você deve utilizar a configuração :linkage => :static. ::: > Exemplo de podfile (Versão 5.0.0 ou superior) ```ruby source 'https://github.com/QITechSDKs/iOS.git' target 'ExampleApp' do use_frameworks! :linkage => :static pod 'QITechIosDeviceScan', '~> 6.0.0' end post_install do |installer| installer.pods_project.targets.each do |target| if ['DatadogCore', 'DatadogInternal', 'DatadogCrashReporting', 'DatadogLogs'].include?(target.name) target.build_configurations.each do |config| config.build_settings['IPHONEOS_DEPLOYMENT_TARGET'] = '15.5' config.build_settings['BUILD_LIBRARY_FOR_DISTRIBUTION'] = 'YES' end end end end ``` > Exemplo de podfile (Versões Anteriores) ```ruby source 'https://github.com/QITechSDKs/iOS.git' target 'ExampleApp' do use_frameworks! pod 'QITechIosDeviceScan', '~> 2.0.0' end post_install do |installer| installer.pods_project.targets.each do |target| if ['DatadogCore', 'DatadogInternal', 'DatadogCrashReporting', 'DatadogLogs'].include?(target.name) target.build_configurations.each do |config| config.build_settings['IPHONEOS_DEPLOYMENT_TARGET'] = '15.5' config.build_settings['BUILD_LIBRARY_FOR_DISTRIBUTION'] = 'YES' end end end end ``` :::info **Atenção** É necessário habilitar a estabilidade do módulo para a dependência de monitoramento 'Datadog'. Para evitar possíveis problemas de compilação para diferentes versões do swift. Portanto, adicione o bloco descrito no post_install do seu arquivo Podfile (ou inclua-o no bloco post_install existente, caso já tenha um) ::: :::warning Atenção Ao integrar dependências no iOS, pode surgir a necessidade de usar linkagem estática para algumas bibliotecas e dinâmica para outras. Essa configuração é relevante para garantir compatibilidade, evitar erros de build e otimizar o desempenho do projeto. ::: ### Linkagem Híbrida de Dependências (caso necessário) A necessidade de linkagem híbrida surge porque algumas bibliotecas têm requisitos específicos, sendo que algumas precisam de linkagem estática para evitar conflitos internos e duplicação de símbolos e outras dependências podem precisar linkagem dinâmica, pois são projetadas para modularidade e compartilhamento entre projetos. Diferenças Entre Linkagem Estática e Dinâmica * Estática (static_framework): O código da biblioteca é incorporado diretamente no binário final, reduzindo o tempo de carregamento em runtime e eliminando dependências externas durante a execução. * Dinâmica (dynamic_framework): A biblioteca é carregada em tempo de execução como um arquivo separado. Isso reduz o tamanho do binário final e facilita atualizações/modificações independentes. > Configurando linkagem híbrida no Podfile ```ruby ... use_frameworks! :linkage => :dynamic # CONFIGURANDO O MODO PADRÃO DE LINKAGEM PARA DINÂMICO ... static_frameworks = ['framework_1', 'framework_2', ...] # INCLUIR TODAS AS DEPENDÊNCIAS QUE PRECISAM SER LINKADAS DE MODO ESTÁTICO pre_install do |installer| installer.pod_targets.each do |pod| if static_frameworks.include?(pod.name) def pod.static_framework?; true end def pod.build_type; Pod::BuildType.static_framework end end end end ``` > Instalando as dependencias ```shell pod install ``` Por fim, execute o comando `pod install` para baixar e instalar as dependências. --- # Permissões URL: /documentation/caas/device_scan/ios/permissions A SDK coleta dados do dispositivo e, de acordo com o funcionamento do sistema operacional iOS, necessita de permissões específicas para cada dado a ser coletado. De maneira a oferecer uma experiência customizada para os usuários da aplicação que possua o SDK embarcado, implementamos um mecanismo que utiliza os parâmetros passados pelo desenvolvedor para solicitar as permissões ao usuário, seguindo a seguinte mecânica: As permissões que forem enviadas como parâmetro do método `requestPermissions`, no formato de String, são solicitadas ao usuário - a menos que já tenham sido solicitadas anteriormente. O usuário, por meio de uma caixa de diálogo disponibilizada pelo próprio sistema operacional, é questionado sobre as permissões consideradas necessárias pelo framework. As permissões são então concedidas ou negadas e, no momento que o método `collectData`, este coletará apenas os dados cuja permissão foi concedida. :::info **Atenção** Caso seu aplicativo já tenha solicitado as permissões necessárias, não é necessário chamar novamente o método `requestPermissions`, o SDK irá herdar as permissões solicitadas pelo aplicativo. ::: ## Permissões utilizadas pelo SDK Na versão atual do SDK, as seguintes permissões são utilizadas caso estejam disponíveis: * location - Captura de dados de geolocalização do device ## Arquivo Info.plist O primeiro passo para disponibilizar permissões para o SDK é configurar a permissão no arquivo Info.plist da aplicação, utilizando a seguinte linha de código para cada uma das permissões desejadas: * location - Captura de dados de geolocalização do device: ` NSLocationWhenInUseUsageDescription ` ` Adicionar a mensagem que você deseja que apareça para o usuário quando o iOS solicitar a permissão de acesso à geolocalização ` :::info **Atenção** Para melhorar a experiência do usuário no momento da solicitação das permissões você deve personalizar a mensagem reproduzida no pop-up de solicitação conforme descrito anteriormente. ::: --- # Compatibilidade URL: /documentation/caas/device_scan/react_native/compatibility O módulo `@qitech/react-native-device-scan` exige as seguintes versões mínimas: | Configuração | Versão mínima | |------------|--------------| |React Native|0.74| |React|18.2.0| |iOS|15.5| |Android API Level|35 (Android 15)| |Datadog SDK nativo (iOS, trazido pelo módulo)|3.x| ## Versão atual do pacote | Pacote | Versão | |--------|--------| |`@qitech/react-native-device-scan`|`1.2.0`| |`@qitech/react-native-caas`|`11.3.0`| :::warning Atenção Nossos SDKs de iOS só suportam simuladores em máquinas com arquitetura **arm64** (M1/M2/M3/M4) com o **Rosetta** ativo, traduzindo a arquitetura x86_64. Recomendamos o uso de dispositivos físicos para testes. ::: ## Expo O pacote inclui um _config plugin_ do Expo que aplica automaticamente as configurações nativas de iOS e Android. Veja [Instalação](/documentation/caas/device_scan/react_native/installation). :::info **Atenção** O módulo não funciona no _Expo managed workflow_ sem `prebuild` — é necessário gerar os projetos nativos com `npx expo prebuild`. ::: --- # A função startDeviceScan URL: /documentation/caas/device_scan/react_native/device_scan_object ## Chamada Para utilizar o módulo de Device Scan, é necessário realizar a chamada da função `startDeviceScan`, que possui os seguintes parâmetros **posicionais**: ```javascript await startDeviceScan( token, document_number, session_id, event_id, event_type, environment ); ``` | Parâmetro | Tipo | Função | Obrigatório | |------------|--------------|--------------|--------------| |token|string|Token de autenticação temporário obtido por meio de requisição server-to-server à API de Device Scan. Deve ser gerado com o mesmo `session_id` passado a esta função.|Sim.| |document_number|string|O número do documento do usuário (CPF/CNPJ sem pontos, traços e barra).|Sim.| |session_id|string|Chave que identifica a sessão da qual os dados coletados são provenientes. **Deve ser enviada em letras minúsculas.**|Sim.| |event_id|string|Um identificador do evento sendo reportado.|Sim.| |event_type|string|Um enumerador que define o tipo de evento sendo reportado (ex.: `'onboarding'`). É pedido cuidado para que eventos muito similares sejam reportados com o mesmo enumerador, a fim de que inteligência possa ser construída sobre esses dados.|Sim.| |environment|CAAS_ENVIRONMENT|Enumerador utilizado para configurar o ambiente de execução para `SANDBOX` ou `PRODUCTION`.|Sim.| :::warning Atenção A ordem dos parâmetros importa. Note que `session_id` vem **antes** de `event_id` e `event_type` na assinatura da função, mesmo que internamente o módulo nativo receba os valores em outra ordem. ::: ## CAAS_ENVIRONMENT ```typescript enum CAAS_ENVIRONMENT { PRODUCTION = 'production', SANDBOX = 'sandbox', } ``` ## Retorno A função retorna uma `Promise` resolvida com uma string indicando o sucesso da coleta. ### Sucesso ```javascript Success collecting device scan data ``` ### Erro A _Promise_ é rejeitada quando a coleta falha: ```javascript There was an error collecting DeviceScan data ``` Quando o módulo nativo não está corretamente vinculado, a chamada lança: ```javascript The package '@qitech/react-native-device-scan' doesn't seem to be linked. Make sure: - You have run 'pod install' - You rebuilt the app after installing the package - You are not using Expo managed workflow ``` ## Exemplo ```tsx try { const result = await startDeviceScan( token, '', '', '1', 'onboarding', CAAS_ENVIRONMENT.SANDBOX ); console.log(result); // "Success collecting device scan data" } catch (error) { console.log('Error executing device scan: ' + error); } ``` ## Utilizando o pacote completo Se o seu aplicativo utiliza o `@qitech/react-native-caas`, a função `startDeviceScan` tem exatamente a mesma assinatura e o mesmo comportamento — apenas o caminho do `import` muda: ```javascript import { CAAS_ENVIRONMENT, startDeviceScan } from '@qitech/react-native-caas'; ``` --- # Implementação URL: /documentation/caas/device_scan/react_native/example ## Pré-requisito: obtendo o token A função `startDeviceScan` exige um `token`. Esse token é temporário e deve ser gerado no seu backend por meio de uma requisição server-to-server para a nossa API, antes de chamar a função do SDK. ### Endpoint | Ambiente | URL | |----------|-----| | **Sandbox** | `https://d.sandbox.viewpkg.com/device_scan/token` | | **Produção** | `https://d.viewpkg.com/device_scan/token` | ### Requisição **Method:** `POST` **Headers:** ```json { "Authorization": "YOUR_DEVICE_SCAN_API_KEY" } ``` **Body:** ```json { "session_id": "unique_session_id" } ``` ### Resposta A resposta bem-sucedida conterá o `token` que deve ser repassado à função `startDeviceScan`. ```json { "token": "eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6..." } ``` :::danger Aviso Importante! A API Key de Device Scan nunca deve ser embarcada no aplicativo. A requisição acima deve partir exclusivamente do seu backend. O `session_id` usado para gerar o token deve ser **o mesmo** repassado à função `startDeviceScan`. ::: :::note O device scan pode ser executado de forma assíncrona. Portanto, não é necessário bloquear a interface para aguardar a resolução da _Promise_. O usuário pode interagir normalmente com o app enquanto o device scan é processado em segundo plano. ::: :::note Recomendamos que o device scan seja executado o mais cedo possível — por exemplo, dentro de um `useEffect`. Como ele pode precisar de mais tempo de execução para coletar todos os dados, essa chamada antecipada garante que as informações mais completas do dispositivo sejam extraídas. ::: ## Assinatura da função ```javascript await startDeviceScan( token, // string - token obtido na API document_number, // string - CPF do usuário session_id, // string - identificador da sessão event_id, // string - identificador do evento event_type, // string - tipo do evento (ex.: 'onboarding') environment // CAAS_ENVIRONMENT.SANDBOX ou CAAS_ENVIRONMENT.PRODUCTION ); ``` Veja [A função startDeviceScan](/documentation/caas/device_scan/react_native/device_scan_object) para a descrição completa de cada parâmetro. ## Exemplo completo ```tsx import * as React from 'react'; import { useCallback, useEffect } from 'react'; import { View, Button, Platform, PermissionsAndroid, Permission } from 'react-native'; import { request, PERMISSIONS, RESULTS } from 'react-native-permissions'; import { CAAS_ENVIRONMENT, startDeviceScan } from '@qitech/react-native-device-scan'; const DEVICE_SCAN_API_URL = 'https://d.sandbox.viewpkg.com/device_scan/token'; const DEVICE_SCAN_API_KEY = ''; const config = { environment: CAAS_ENVIRONMENT.SANDBOX, sessionId: '', documentNumber: '', deviceScanEventId: '1', deviceScanEventType: 'onboarding', }; export default function App() { // Etapa 1: solicitar as permissões que ampliam a coleta const requestDeviceScanPermissions = async (): Promise => { if (Platform.OS === 'ios') { const result = await request(PERMISSIONS.IOS.LOCATION_WHEN_IN_USE); return result === RESULTS.GRANTED; } const permissionsToRequest: Permission[] = [ PermissionsAndroid.PERMISSIONS.ACCESS_FINE_LOCATION, PermissionsAndroid.PERMISSIONS.ACCESS_COARSE_LOCATION, PermissionsAndroid.PERMISSIONS.READ_PHONE_STATE, PermissionsAndroid.PERMISSIONS.READ_CONTACTS, ]; // BLUETOOTH_CONNECT só é necessária no Android 12+ (API 31+) if (Platform.Version >= 31) { permissionsToRequest.push('android.permission.BLUETOOTH_CONNECT' as Permission); } const results = await PermissionsAndroid.requestMultiple(permissionsToRequest); return ( results[PermissionsAndroid.PERMISSIONS.ACCESS_FINE_LOCATION] === PermissionsAndroid.RESULTS.GRANTED || results[PermissionsAndroid.PERMISSIONS.ACCESS_COARSE_LOCATION] === PermissionsAndroid.RESULTS.GRANTED ); }; // Etapa 2: obter o token por meio do seu backend const fetchDeviceScanToken = useCallback(async () => { const response = await fetch(DEVICE_SCAN_API_URL, { method: 'POST', headers: { 'Authorization': DEVICE_SCAN_API_KEY, 'Content-Type': 'application/json', }, body: JSON.stringify({ session_id: config.sessionId }), }); if (!response.ok) { throw new Error(`HTTP ${response.status}`); } const data = await response.json(); if (!data.token) { throw new Error("No 'token' found in response."); } return data.token; }, []); // Etapa 3: executar a coleta const captureDeviceScan = async (): Promise => { try { const deviceScanToken = await fetchDeviceScanToken(); const result = await startDeviceScan( deviceScanToken, config.documentNumber, config.sessionId, config.deviceScanEventId, config.deviceScanEventType, config.environment ); console.log('Device Scan result: ' + String(result)); } catch (error) { console.log('Error executing device scan: ' + error); } }; useEffect(() => { const init = async () => { await requestDeviceScanPermissions(); await captureDeviceScan(); }; init(); }, []); return (