microblink/blinkid-android

BlinkID SDK for Android – 是什么

BlinkID 是一个商业 Android 库，允许应用开发者在设备上扫描身份文件（护照、驾照、身份证等）并提取其中的数据。该 SDK 集成了机器学习模型、原生 C++ 核心，以及一个可作为 Jetpack Compose 组件或传统 Android 活动使用的现成用户界面。

---

谁会用它？

• 需要验证用户身份的移动应用（KYC、银行、旅行、酒店业）。
• 希望快速获得开箱即用解决方案，而非从零构建 OCR/ML 流水线的开发者。
• 偏好 Kotlin/Compose 但同时支持旧版 Java 代码的团队。

---

主要功能（如 README 所述）

功能	含义
文档覆盖范围	支持多种类型的身份证件；具体列表请见 Microblink 官方文档网站。
结果模型	扫描后返回一个 BlinkIdScanningResult 对象，其中包含结构化字段（姓名、出生日期、证件号码等），数据来源按可靠性排序：条形码 > MRZ > 视觉识别。
两种集成方式	• BlinkIdCameraScanningScreen – 用于单活动、完全可定制 UI 的 Compose 组件。 • BlinkIdScanActivity – 适用于纯 Java 或最小定制需求的应用的现成活动。
自定义	通过 UxSettings、UiSettings、CameraSettings 和 BlinkIdSessionSettings，可调整颜色、字体、字符串、遮蔽、超时值、相机设置，甚至低级别会话参数。
资源管理	机器学习模型以可下载资源形式提供。您可以：* 在运行时下载，* 打包进 APK，或 * 启用 OTA 更新以保持模型最新。
设备要求	Android API 24+，ARMv7/ARM64 原生二进制文件，以及支持至少 1080p 预览的摄像头。
许可证	需要一个与应用包名绑定的试用或付费许可证密钥；密钥从 Microblink 开发者中心获取。
文档与示例	KDoc API 参考、在线文档、迁移指南，以及三个示例应用（Compose、直接 API、Java）。

---

如何快速上手（概要）

1. 添加 Maven Central 依赖

   implementation "com.microblink:blinkid-ux:8002.0.0"
   

2. 从 Microblink 开发者门户获取许可证密钥。
3. 使用您的密钥初始化 SDK（一个挂起函数）：

   val sdk = BlinkIdSdk.initializeSdk(context, BlinkIdSdkSettings(licenseKey = "YOUR_KEY"))
   

4. 启动扫描 UI – 选择 Compose 组件或活动，传入 sdk 实例和所需的自定义设置。
5. 处理结果 – 回调将返回一个 BlinkIdScanningResult，包含所有提取的字段。

---

README 未提及的内容

• 无设备端训练 – 模型为预训练并作为资源分发。
• 无开源代码 – 仓库仅包含集成包装器；核心 ML 引擎为专有。
• 除免费试用外，定价详情未公开。

---

总结

blinkid-android 仓库是一个真正的 AI 驱动的 Android 文档扫描 SDK。它提供了一个开箱即用的流水线（摄像头 → ML 模型 → 结构化数据）和灵活的 UI 层，专为那些希望在不构建自有计算机视觉栈的情况下实现可靠 ID 采集的开发者而设计。