接收结果

SDK 通过传递给 open() 的 callback 对象返回采集结果。success 和 error 处理程序均为必填项。

自拍采集

success（自拍）

图像成功采集后调用。接收包含以下内容的对象：

• base64 — 采集的图像；可用于在您的应用中显示预览。
• encrypted — JWT 载荷，必须发送至您的后端，以通过 REST API 完成生物特征验证。

const callback = {
  on: {
    success: (obj) => {
      const base64 = obj.base64;
      const encrypted = obj.encrypted; // JWT to send to your backend
    },
    error: (error) => {
      console.error(error);
    }
  }
};

encrypted 使用说明

• encrypted 属性严格用于通过客户端 API 发送图像。不得对其进行打开或序列化——其特性可能在未事先通知的情况下发生变化。Unico 对因不当处理造成的任何损失不承担责任。
• base64/encrypted 文件的大小可能因设备质量、生成的照片大小以及 Unico 的业务规则而有所不同。不要在您的编程逻辑或基础设施中限制 SDK 生成的字符串大小。

error（自拍）

采集过程中发生错误时调用。接收包含 getCode() 和 getDescription() 的 ErrorBio 对象。完整的错误代码列表请参阅错误处理。

error: (error) => {
  const code = error.getCode();
  const description = error.getDescription();
}

文件采集

success（文件）

文件图像成功采集后调用。接收包含以下内容的对象：

• base64 — 采集的图像；可用于显示预览。
• encrypted — JWT 载荷，必须在 10 分钟内发送至您的后端，且绝不得修改或反序列化。

const callback = {
  on: {
    success: (obj) => {
      const base64 = obj.base64;
      const encrypted = obj.encrypted;
    },
    error: (error) => { /* ... */ }
  }
};

error（文件）

文件采集过程中发生错误时调用。接收一个 ErrorBio 对象。完整的错误代码列表请参阅错误处理。