---
title: SDK 与工具
description: IDCloud SDK 与集成工具概览 — Web SDK、Android SDK、iOS SDK、Flutter SDK 及 REST API。
canonical: https://developer.unico.io/zh-CN/dual-api/developers/sdks-and-tools/overview
locale: zh-CN
generated_by: markdown-export
---

Unico SDK 直接嵌入您的应用程序，在客户端管理采集体验。成功采集后，SDK 会返回一个加密载荷，您的后端将通过 REST API 将其转发给 IDCloud 生物识别引擎进行分析。

### 可用 SDK

  **Android SDK**

适用于 Java 和 Kotlin 应用程序的原生库。

  **iOS SDK**

适用于 Swift 和 Objective-C 应用程序的原生库。

  **Flutter SDK**

基于 Android 和 iOS 原生 SDK 构建的插件。

  **Web SDK**

用于浏览器端采集流程的 JavaScript 库。

### 示例应用（PoC）

在开始集成之前，探索各 SDK 官方的概念验证（PoC）应用——这些应用是针对主要采集流程的已验证、保持最新的实现。

- [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 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 — 请联系您的项目经理获取 |
| Vue JS | [GitHub — unico-sdk-poc-vuejs](https://github.com/unico-labs/unico-sdk-poc-vuejs) |

### 主要功能

## 活体验证

SDK 与活体能力集成，以确认用户在采集时实际在场。只有在活体验证通过后，采集会话才会完成，从而阻止照片、视频或面具等欺骗尝试。

## SmartFrames

采集界面会自动适应用户的轮廓和屏幕尺寸。与标准相机实现相比，这提高了生物特征的有效性并减少了被拒绝的采集次数，且无需开发人员进行任何配置。

### 安全层

每个 SDK 在运行时均应用了多项安全控制：

- 客户端与后端之间的载荷加密
- 注入和篡改防护
- 跨相机模式的欺诈检测
- 代码混淆
- 模拟器拦截
- 应用包验证

### 工作原理

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 在客户端处理完整的采集流程：相机访问、帧验证、活体检测和加密。您的后端接收加密载荷并将其转发给 IDCloud 生物识别引擎——不传输任何原始图像。
这些 SDK 为 Web & SDK 合约（`POST /client/v1/process`）生成输出。对于 API 合约，采集在您自己的界面上处理，`imageBase64` 直接发送。

## 版本管理

SDK 版本遵循语义化版本控制（`MAJOR.MINOR.PATCH`）。SDK 更新责任取决于您的集成模式。对于**客户端（by-Client）**集成，保持 SDK 为最新版本是您的责任——过期版本可能失去安全覆盖或无法访问新功能。对于 **Unico 托管（by-Unico）**集成，Unico 会自动推送更新。

- **主版本（MAJOR）：** 对 API 进行不兼容更改时。
- **次版本（MINOR）：** 在保持兼容性的同时添加功能时。
- **修订版本（PATCH）：** 在保持兼容性的同时修复错误时。

:::warning[支持的环境]
支持：原生 Android、原生 iOS，以及通过我们插件使用的 Flutter。不支持：任何混合或跨平台框架，包括但不限于 React Native 和 Ionic。
:::