SDK 结果分别由以下两个回调返回:
如果您只需要获取刷脸结果,不需要拉取视频和照片,您可以信任前端SDK核身结果,返回中的 isSuccess 字段 True 代表人脸核身对比成功;false 代表人脸核身失败。核身 SDK 和核身后台服务之间通信采用加密方式,可以有效防止结果篡改。
/** * 登录回调接口 返回登录 sdk 是否成功 */ export interface WbCloudFaceVerifyLoginCallback { onLoginSuccess: () => void; onLoginFail: (error: WbFaceError) => void; } /** * 刷脸结果回调接口 */ export interface WbCloudFaceVerifyResultCallback { onFinish: (result: WbFaceVerifyResult) => void; }
WbFaceVerifyResult对象说明
WbFaceVerifyResult 是 SDK 用来给合作方传递身份识别结果的对象,在 WbCloudFaceVerifyResultListener 回调中作为参数返回给合作方 App。WbFaceVerifyResult 对象的各个字段意义如下表所示:
字段名 | 类型 | 字段含义 | 说明 |
isSuccess | boolean | 人脸核身是否成功 | True 代表人脸核身对比成功;false 代表人脸核身失败,具体的失败原因请参考WbFaceError 对象说明 |
sign | String | 签名 | 供 App 校验人脸核身结果的安全性 |
liveRate | String | 活体检测分数 | - |
similarity | String | 人脸比对分数 | “仅活体检测” 类型不提供此分数 |
WbFaceError | 自定义对象 | 人脸核身错误 | 人脸核身成功时为 null |
WbFaceError 对象说明
WbFaceError 是 SDK 用来给合作方传递人脸核身错误信息的对象,在 WbCloudFaceVerifyLoginListener 回调和 WbFaceVerifyResult 对象中作为参数返回给合作方 App。WbFaceError 对象的各个字段意义如下表所示,各个字段的内容取值详情请参见 SaaS服务错误码。
字段名 | 类型 | 字段含义 | 说明 |
domain | String | 错误发生的阶段 | 只有当 domain=WBFaceErrorDomainCompareServer 时表示用户完成了刷脸,可以通过接口去拉取刷脸结果。其他 domain 表示用户刷脸中途退出或命中了风控逻辑,后端无法查询到刷脸结果 |
code | String | 错误码 | - |
desc | String | 错误描述 | 如有需求,可以展示给用户 |
reason | String | 错误信息内容 | 错误的详细实际原因,主要用于定位问题 |