跳转到主要内容

SDK 与工具

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

可用 SDK​

Android SDK

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

开始使用发行说明
当前版本6.5.0
语言Kotlin / Java
最低版本5.0 (API 21)
Kotlin1.8.22+
iOS SDK

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

开始使用发行说明
当前版本3.0.0
语言Swift / Objective-C
最低版本iOS 13
Xcode16.0+
Flutter SDK

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

开始使用发行说明
当前版本4.52.0
语言Dart
Android 最低版本5.0 (API 21)
iOS 最低版本iOS 13
Web SDK

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

开始使用发行说明
当前版本3.23.7
语言JavaScript
模块ESM / CommonJS
Chrome85+
Firefox94+
Safari11+

主要功能​

活体验证

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。

最后更新 于