跳转到主要内容

错误处理

Web SDK 的所有错误处理都集中在本节。error 回调接收一个 ErrorBio 对象，该对象暴露了 getCode() 和 getDescription() 方法。

prepareCamera 错误
代码描述
73000正常使用 SDK API 时发生未知的意外错误
73001<property> 为必填项
73002<property> 必须是 <class> 的实例
73003名为 <name> 的 <class> 无法注入
73004类类型必须是函数或类
73005找不到 <locale> 语言环境
73006找不到文本：<text>
73100无法连接到互联网
73200找不到 Unico SDK JSON 文件
73201无法加载 Unico SDK JSON 文件
73202Unico SDK JSON 文件无效
73204无法初始化 SDK — 请在构建时通过 setEnvironment 配置环境
73300无法对此应用程序进行身份验证
73301无法对此应用程序进行身份验证
73302未找到身份验证令牌
73303当前主机未注册
73400无法初始化摄像头
73401无法为此摄像头加载 ML 模型
73402由于用户设备的连接问题，无法验证密钥
73403此设备/平台/浏览器/版本组合不受 SDK 支持
73404设备处于横屏方向。SDK 只能在竖屏模式下使用
73405由于多次尝试失败，设备已被封锁
73406会话已取消 — SDK 在 iFrame 中打开
73407SDK 未完全加载
73500无法获取会话
73501无法获取会话
73502未找到会话令牌
73600找不到摄像头资源
73601无法在生产模式下启动摄像头
74000无效的十六进制值
74001对象不是 UnicoTheme
openCamera 错误
代码描述
73700无法解析摄像头响应
73704用户按下取消按钮，未完成会话
73706摄像头访问被拒绝 — 用户明确拒绝了权限，或设备策略阻止了访问
73707会话因应用程序终止、休眠、系统通知或转入后台而取消
73708会话因设备处于横屏模式而取消
73710会话因用户未能在规定时间内完成而取消
73715会话因未配置所有引导图像而取消
73716会话因 SDK 无法在此设备上启动摄像头而取消
73717会话因用户处于锁定状态而取消
73718正常使用 SDK API 时发生未知的意外错误
73720开发者通过编程方式调用了会话取消 API
73721会话因会话过程中设备方向改变而取消
73722会话因文档未就绪而取消
73723会话因存在另一个正在进行的会话而取消
73724会话因摄像头在 iFrame 中打开而取消
73728连接错误 — 请使用 HTTPS 进行连接
73729浏览器不受支持 — 请在其他浏览器中打开
73730无法初始化活体检测会话 — 未知许可证错误
73731无法初始化活体检测会话 — 许可证已过期
73732无法初始化活体检测会话 — 来源不被允许
73800无法加密响应
73900无法获取系统信息
官方错误目录

上述代码反映了 Web SDK 目录。官方的跨平台错误代码目录可在 API 参考 > 错误代码 中找到。

处理回调
const callback = {
  on: {
    success: (obj) => {
      console.log(obj.base64);
      console.log(obj.encrypted);
    },
    error: (error) => {
      const code = error.getCode();
      const description = error.getDescription();
      // handle error
    }
  }
};
必填回调

callback 对象是必填项。如果未正确实现（覆盖 success 和 error 事件），SDK 将抛出异常，如果未处理该异常，则会显示在用户的控制台中。

最后更新 于