SDK 与工具

MarkdownChatGPTClaude

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

可用 SDK

Android SDK

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

开始使用发行说明

当前版本6.10.1

语言Kotlin / Java

最低版本5.0 (API 21)

Kotlin1.8.22+

iOS SDK

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

开始使用发行说明

当前版本3.3.0

语言Swift / Objective-C

最低版本iOS 13

Xcode16.0+

Flutter SDK

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

开始使用发行说明

当前版本4.62.0

语言Dart

Android 最低版本5.0 (API 21)

iOS 最低版本iOS 13

Web SDK

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

开始使用发行说明

当前版本3.28.1

语言JavaScript

模块ESM / CommonJS

Chrome85+

Firefox94+

Safari11+

示例应用（PoC）

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

• Android
• iOS
• Flutter
• Web
• Web App Integration（Journeys SDK）

原生 SDK

平台	流程	仓库
Android	活体检测	GitHub — unico-sdk-poc-kotlin
Android	User Journeys	GitHub — unico-sdks-poc-kotlin
iOS	活体检测	GitHub — unico-sdk-poc-ios-swift
iOS	User Journeys	GitHub — unico-sdks-poc-swift
Flutter	活体检测	GitHub — unico-sdk-poc-flutter
Flutter	User Journeys	GitHub — unico-sdks-flutter

Web App Integration（Journeys SDK）

语言 / 框架	仓库
Angular	GitHub — unico-cbu-poc-angular
JS Vanilla	GitHub — unico-cbu-poc-js
React	GitHub — unico-cbu-poc-react
Vue JS	GitHub — unico-cbu-poc-vuejs

Web SDK

语言 / 框架	仓库
Angular	GitHub — unico-sdk-poc-angular
JS Vanilla	GitHub — unico-sdk-poc-js-vanilla
Next.js	GitHub — unico-sdk-poc-next-js
React JS with TypeScript	GitHub — unico-webframe-poc-react
React JS with JavaScript	GitHub — unico-sdk-poc-react-js
React JS with Webpack + Babel	SFTP — 请联系您的项目经理获取
Vue JS	GitHub — unico-sdk-poc-vuejs

主要功能

活体验证

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

SmartFrames

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

安全层

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

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

工作原理

SDK（客户端）负责简化您与 Unico 平台的集成，处理相机操控、图像采集和用户旅程的所有复杂性。

如果采集成功，SDK 会返回一个加密载荷，该载荷必须发送给生物识别引擎 API，从而完成生物特征验证，如下图所示：

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）： 在保持兼容性的同时修复错误时。

支持的环境

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