错误处理
iOS SDK 的所有错误处理集中在本节。onErrorAcessoBioManager 回调接收一个 ErrorBio 对象，该对象暴露 getCode() 和 getDescription()。
错误代码
| 代码 | 描述 |
|---|---|
73000 | 会话因未知且意外的错误而被取消。Unico Check SDK 使用了多种 iOS API，包括相机、存储、安全、网络等——这是一个通用捕获错误。 |
73001 | 上下文无效 |
73003 | API 版本需为 13 或更高 |
73006 | 无法在模拟器上打开相机 |
73100 | 无法连接互联网 |
73200 | 找不到 unico_sdk JSON 文件 |
73202 | 无法加载 unico_sdk JSON 文件 |
73203 | 无法加载 AcessoBioConfigDataSource |
73204 | 无法初始化 SDK——请通过构建时的 setEnvironment 配置环境 |
73300 | 无法获取 unico 认证 对象 |
73301 | 无法解析 unico 认证对象 |
73302 | 找不到 unico token |
73701 | 找不到活体检测导入 |
73702 | 无法在生产模式下初始化活体检测 |
73703 | 无法获取活体检测会话 |
73704 | 用户按下取消按钮，未完成会话 |
73705 | 会话未成功执行，未生成 FaceScan |
73706 | 相机访问被拒绝——用户明确拒绝了权限或设备策略阻止了访问 |
73707 | 会话因应用终止、休眠、系统通知或进入后台而被取消 |
73708 | 会话因设备处于横屏模式而被取消 |
73709 | 会话因设备处于反向竖屏模式而被取消 |
73710 | 会话因用户在规定超时时间内未能完成而被取消 |
73711 | 会话因内存压力而被取消 |
73712 | 会话因应用不在生产环境且需要网络连接而被取消 |
73713 | 会话因密钥需要重新验证而被取消 |
73714 | 会话因开发者配置的加密密钥无效而被取消 |
73715 | 会话因未配置所有引导图像而被取消 |
73716 | 会话因 SDK 无法在此设备上启动相机而被取消 |
73717 | 会话因用户处于锁定状态而被取消 |
73718 | 正常使用 iOS API 时发生未知且意外的错误 |
73719 | 会话因用户按下准备页面的副文本消息而被取消 |
73720 | 会话未被处理 |
73721 | 无法执行会话：已超出尝试次数限制 |
73722 | 无法执行会话：人脸对齐超时 |
73730 | 无法初始化活体检测会话——未知许可证错误 |
73731 | 无法初始化活体检测会话——许可证已过期 |
73800 | 无法构建加密密钥 |
官方错误目录
上述代码反映了 iOS SDK 目录。官方跨平台错误代码目录可在 API 参考 > 错误代码 中查看。
生命周期回调
除 onErrorAcessoBioManager 外，SDK 还会触发以下回调：
onUserClosedCameraManually()— 用户手动关闭了相机。onSystemClosedCameraTimeoutSession()— 会话因超时而过期（默认 40 秒，最小 40 秒）。onSystemChangedTypeCameraTimeoutFaceInference()— 人脸检测超过 13 秒阈值；采集切换为手动模式。