--- title: SDK и инструменты description: Обзор SDK и инструментов интеграции IDCloud — Web SDK, Android SDK, iOS SDK, Flutter SDK и REST API. canonical: https://developer.unico.io/ru/dual-api/developers/sdks-and-tools/overview locale: ru generated_by: markdown-export --- SDK Unico встраивается непосредственно в ваше приложение и управляет процессом захвата на стороне клиента. После успешного захвата SDK возвращает зашифрованные данные, которые ваш бэкенд передаёт в биометрический движок IDCloud для анализа через REST API. ### Доступные SDK **Android SDK** Нативная библиотека для приложений на Java и Kotlin. **iOS SDK** Нативная библиотека для приложений на Swift и Objective-C. **Flutter SDK** Плагин, построенный на основе нативных SDK для Android и iOS. **Web SDK** JavaScript-библиотека для процессов захвата изображения в браузере. ### Примеры приложений (PoC) Ознакомьтесь с официальными приложениями Proof of Concept (PoC) для каждого SDK перед началом интеграции — проверенными и актуальными реализациями основных сценариев захвата. - [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) - [Web App Integration (Journeys SDK)](/developers/sdks-and-tools/web) **Нативные SDK** | Платформа | Сценарий | Репозиторий | |---|---|---| | Android | Проверка живости | [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 | Проверка живости | [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 | Проверка живости | [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) | **Web App Integration (Journeys SDK)** | Язык / Фреймворк | Репозиторий | |---|---| | 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** | Язык / Фреймворк | Репозиторий | |---|---| | 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 с TypeScript | [GitHub — unico-webframe-poc-react](https://github.com/unico-labs/unico-webframe-poc-react) | | React JS с JavaScript | [GitHub — unico-sdk-poc-react-js](https://github.com/unico-labs/unico-sdk-poc-react-js) | | React JS с Webpack + Babel | SFTP — запросите у вашего Project Manager | | Vue JS | [GitHub — unico-sdk-poc-vuejs](https://github.com/unico-labs/unico-sdk-poc-vuejs) | ### Ключевые возможности ## Проверка живости SDK интегрируются с функцией Liveness для подтверждения физического присутствия пользователя в момент захвата. Сеанс захвата завершается только после успешной проверки живости, что блокирует попытки спуфинга с использованием фотографий, видео или масок. ## SmartFrames Интерфейс захвата автоматически адаптируется к силуэту пользователя и размерам экрана. Это улучшает качество биометрических данных и снижает количество отклонённых захватов по сравнению со стандартными реализациями камеры — без какой-либо настройки со стороны разработчика. ### Уровни безопасности Каждый SDK поставляется с несколькими средствами защиты, применяемыми во время выполнения: - Шифрование полезной нагрузки между клиентом и backend - Защита от инъекций и подмены данных - Обнаружение мошенничества во всех режимах камеры - Обфускация кода - Блокировка эмуляторов - Верификация пакета приложения ### Принцип работы SDK (на стороне клиента) упрощает интеграцию с платформой Unico, берёт на себя всю сложность управления камерой, захвата изображений и пользовательского пути. При успешном захвате SDK возвращает зашифрованные данные, которые необходимо отправить в API биометрического движка для завершения биометрической валидации, как показано на схеме ниже: ```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 ``` SDK управляет полным процессом захвата на клиенте: доступ к камере, валидация кадров, проверка живости и шифрование. Ваш backend получает зашифрованные данные и передаёт их в биометрический движок IDCloud — необработанное изображение не передаётся. Эти SDK формируют вывод для контракта Web & SDK (`POST /client/v1/process`). При использовании API-контракта захват выполняется на вашей стороне, и `imageBase64` отправляется напрямую. ## Версионирование Версии SDK следуют семантическому версионированию (`MAJOR.MINOR.PATCH`). Ответственность за обновление SDK зависит от модели интеграции. Для интеграций **by-Client** поддержание актуальной версии SDK является вашей ответственностью — устаревшие версии могут потерять защиту безопасности или доступ к новым возможностям. Для интеграций **by-Unico** обновления выполняются Unico автоматически. - **Мажорная версия (MAJOR):** При внесении несовместимых изменений в API. - **Минорная версия (MINOR):** При добавлении функциональности с сохранением совместимости. - **Патч-версия (PATCH):** При исправлении ошибок с сохранением совместимости. :::warning[Поддерживаемые среды] Поддерживаются: нативный Android, нативный iOS и Flutter через наш плагин. Не поддерживаются: любые гибридные или кроссплатформенные фреймворки, включая, помимо прочего, React Native и Ionic. :::