--- title: SDKs e Ferramentas description: Visão geral dos SDKs e ferramentas de integração do IDCloud — Web SDK, Android SDK, iOS SDK, Flutter SDK e API REST. canonical: https://developer.unico.io/pt-BR/dual-api/developers/sdks-and-tools/overview locale: pt-BR generated_by: markdown-export --- Os SDKs da Unico se integram diretamente à sua aplicação para gerenciar a experiência de captura no lado do cliente. Após uma captura bem-sucedida, o SDK retorna um payload criptografado que o seu backend encaminha para o mecanismo biométrico do IDCloud para análise via API REST. ### SDKs disponíveis **Android SDK** Biblioteca nativa para aplicações Java e Kotlin. **iOS SDK** Biblioteca nativa para aplicações Swift e Objective-C. **Flutter SDK** Plugin construído sobre os SDKs nativos Android e iOS. **Web SDK** Biblioteca JavaScript para fluxos de captura baseados em navegador. ### Apps de exemplo (PoCs) Explore aplicativos oficiais de Proofs of Concept (PoCs) para cada SDK antes de iniciar sua integração — implementações validadas e atualizadas dos principais fluxos de captura. - [Android](/developers/sdks-and-tools/android/resources) - [iOS](/developers/sdks-and-tools/ios/resources) - [Flutter](/developers/sdks-and-tools/flutter/resources) - [Web](/dual-api/developers/sdks-and-tools/web/web-sdk/resources) - [Integração Web App (SDK de Jornadas)](/developers/sdks-and-tools/web) **SDKs Nativos** | Plataforma | Fluxo | Repositório | |---|---|---| | Android | Prova de Vida | [GitHub — unico-sdk-poc-kotlin](https://github.com/unico-labs/unico-sdk-poc-kotlin) | | Android | User Journeys | [GitHub — unico-sdks-poc-kotlin](https://github.com/unico-labs/unico-sdks-poc-kotlin) | | iOS | Prova de Vida | [GitHub — unico-sdk-poc-ios-swift](https://github.com/unico-labs/unico-sdk-poc-ios-swift) | | iOS | User Journeys | [GitHub — unico-sdks-poc-swift](https://github.com/unico-labs/unico-sdks-poc-swift) | | Flutter | Prova de Vida | [GitHub — unico-sdk-poc-flutter](https://github.com/unico-labs/unico-sdk-poc-flutter) | | Flutter | User Journeys | [GitHub — unico-sdks-flutter](https://github.com/unico-labs/unico-sdks-flutter) | **Integração Web App (SDK de Jornadas)** | Linguagem / Framework | Repositório | |---|---| | Angular | [GitHub — unico-cbu-poc-angular](https://github.com/unico-labs/unico-cbu-poc-angular) | | JS Vanilla | [GitHub — unico-cbu-poc-js](https://github.com/unico-labs/unico-cbu-poc-js) | | React | [GitHub — unico-cbu-poc-react](https://github.com/unico-labs/unico-cbu-poc-react) | | Vue JS | [GitHub — unico-cbu-poc-vuejs](https://github.com/unico-labs/unico-cbu-poc-vuejs) | **Web SDK** | Linguagem / Framework | Repositório | |---|---| | Angular | [GitHub — unico-sdk-poc-angular](https://github.com/unico-labs/unico-sdk-poc-angular) | | JS Vanilla | [GitHub — unico-sdk-poc-js-vanilla](https://github.com/unico-labs/unico-sdk-poc-js-vanilla) | | Next.js | [GitHub — unico-sdk-poc-next-js](https://github.com/unico-labs/unico-sdk-poc-next-js) | | React JS with TypeScript | [GitHub — unico-webframe-poc-react](https://github.com/unico-labs/unico-webframe-poc-react) | | React JS with JavaScript | [GitHub — unico-sdk-poc-react-js](https://github.com/unico-labs/unico-sdk-poc-react-js) | | React JS with Webpack + Babel | SFTP — solicite ao seu Gerente de Projeto | | Vue JS | [GitHub — unico-sdk-poc-vuejs](https://github.com/unico-labs/unico-sdk-poc-vuejs) | ### Recursos principais ## Verificação de liveness Os SDKs se integram com a capacidade de Liveness para confirmar que o usuário está fisicamente presente no momento da captura. A sessão de captura só é concluída quando o liveness é verificado, bloqueando tentativas de spoofing como fotos, vídeos ou máscaras. ## SmartFrames A UI de captura se adapta automaticamente à silhueta do usuário e às dimensões da tela. Isso melhora a validade biométrica e reduz capturas rejeitadas em comparação com implementações de câmera padrão, sem exigir nenhuma configuração por parte do desenvolvedor. ### Camadas de segurança Cada SDK vem com múltiplos controles de segurança aplicados em tempo de execução: - Criptografia de payload entre cliente e backend - Prevenção de injeção e adulteração - Detecção de fraude em diferentes modos de câmera - Ofuscação de código - Bloqueio de emuladores - Verificação de bundle da aplicação ### Como funciona O SDK (lado do cliente) é responsável por simplificar a sua integração com a plataforma Unico, tratando toda a complexidade de manipulação de câmera, captura de imagem e jornada do usuário. Se a captura for bem-sucedida, o SDK retorna um payload criptografado que deve ser enviado para a API do mecanismo biométrico, completando assim a validação biométrica, conforme ilustrado no diagrama abaixo: ```mermaid sequenceDiagram actor User participant App as Your App participant SDK as Unico SDK participant Server as Your App Backend Server participant Engine as Unico API User->>App: 1. Access Your Application App->>SDK: 2. Render Capture Component SDK-->>App: 3. [Capture Component] App->>App: 4. Capture Image (JWT) App->>Server: 5. Drop JWT to your server Server->>Engine: 6. Iterate with Unico API with jwt Engine->>Server: Biometry response Server->>App: Biometry response App->>User: Feedback ``` O SDK gerencia o fluxo completo de captura no cliente: acesso à câmera, validação de frame, verificação de liveness e criptografia. O seu backend recebe o payload criptografado e o encaminha para o mecanismo biométrico do IDCloud — nenhuma imagem bruta é transmitida. Esses SDKs produzem saída para o contrato Web & SDK (`POST /client/v1/process`). Para o contrato de API, a captura é realizada na sua própria surface e o `imageBase64` é enviado diretamente. ## Versionamento As versões dos SDKs seguem semantic versioning (`MAJOR.MINOR.PATCH`). A responsabilidade pela atualização do SDK depende do modelo de integração. Para integrações **by-Client**, manter o SDK atualizado é sua responsabilidade — versões desatualizadas podem perder cobertura de segurança ou acesso a novas capacidades. Para integrações **by-Unico**, a Unico envia as atualizações automaticamente. - **Versão Maior (MAJOR):** Quando há alterações incompatíveis na API. - **Versão Menor (MINOR):** Quando funcionalidades são adicionadas mantendo compatibilidade. - **Versão de Patch (PATCH):** Quando bugs são corrigidos mantendo compatibilidade. :::warning[Ambientes suportados] Suportados: Android nativo, iOS nativo e Flutter via nosso plugin. Não suportados: qualquer framework híbrido ou cross-platform, incluindo, mas não se limitando a, React Native e Ionic. :::