简介

欢迎使用 QI Tech 人脸识别 SDK 的 React Native 集成手册！@qitech/react-native-caas 模块通过 TypeScript 接口暴露 QI Tech 的 Android（Java/Kotlin）和 iOS（Swift）原生 SDK。您应使用它在 React Native 应用中直接完成客户的活体检测，并通过一个密钥在 QI Tech 系统的其他产品中引用采集到的图像。

可用的包

包	内容	使用场景
@qitech/react-native-caas	人脸识别、OCR 和设备扫描	当您需要人脸识别、OCR 或完整的开户流程时。
@qitech/react-native-device-scan	仅设备扫描	当您仅需要设备扫描时——安装更轻量，原生依赖更少。

重要提示！

两个包都包含设备扫描。请勿同时安装——只选择其中一个。

对于人脸识别，请使用 @qitech/react-native-caas。

遇到问题？

我们不是躲在 API 后面的公司！请联系我们的支持团队，我们将尽快回复。如果您需要快速回复，请随时致电我们！

我们欢迎反馈

即使您已经解决了问题，或者问题非常简单（哪怕只是一个拼写错误或您已经理解的不当排版），也请给我们发邮件——这样我们就能让文档越来越实用，下一个人也不必再经历您经历过的痛苦！

环境

我们为客户提供两个环境。通过 CAAS_ENVIRONMENT 枚举进行选择，该枚举作为 startFaceRecon 函数的第一个参数传入。目前可用的环境如下：

• 生产环境 - CAAS_ENVIRONMENT.PRODUCTION
• 沙盒环境 - CAAS_ENVIRONMENT.SANDBOX

每个环境需要不同的 API Key 来生成 client_session_key。

重要提示！

请勿在 QI Tech 的沙盒环境中使用真实的个人或企业数据。

与设备扫描的集成

人脸识别服务会自动向设备扫描发起一次内部调用。因此，成功返回中包含 device_scan_session_id 字段，用于标识内部执行的设备扫描会话，可与 QI Tech 生态中的其他服务集成使用。

后续步骤

1. 兼容性 — React Native、iOS 和 Android 的最低版本。
2. 安装 — 包安装以及 Android、iOS 和 Expo 的原生配置。
3. 实现 — 获取 client_session_key 以及 startFaceRecon 的完整示例。
4. FaceReconOptions 对象 — 所有自定义参数。
5. 获取返回结果 — 返回结构与错误处理。