有奖捉虫:办公协同&微信生态&物联网文档专题 HOT
Android SDK 结果分别由以下两个回调返回: 如果您只需要获取刷脸结果,不需要拉取视频和照片,您可以信任前端 SDK 核身结果,返回中的 isSuccess 字段 True 代表人脸核身对比成功;false 代表人脸核身失败。核身 SDK 和核身后台服务之间通信采用加密方式,可以有效防止结果篡改。
/**
* 登录回调接口 返回登录 sdk 是否成功
*/
public interface WbCloudFaceVerifyLoginListener {
void onLoginSuccess();
void onLoginFailed(WbFaceError error);
}

/**
* 刷脸结果回调接口
*/
public interface WbCloudFaceVerifyResultListener {
void onFinish(WbFaceVerifyResult result);

WbFaceVerifyResult 对象说明

WbFaceVerifyResult 是 SDK 用来给合作方传递身份识别结果的对象,在 WbCloudFaceVerifyResultListener 回调中作为参数返回给合作方 App。WbFaceVerifyResult 对象的各个字段意义如下表所示:
字段名
类型
字段含义
说明
isSuccess
boolean
人脸核身是否成功
True 代表人脸核身对比成功
false 代表人脸核身失败,具体的失败原因请参考 WbFaceError 对象说明
sign
String
签名
供 App 校验人脸核身结果的安全性
liveRate
String
活体检测分数
-
similarity
String
人脸比对分数
“仅活体检测” 类型不提供此分数
RiskInfo
自定义对象
后台返回的刷脸风险信息
详见备注说明。
请注意:部分情况下此字段不返回,请不要做强校验
WbFaceError
自定义对象
人脸核身错误
人脸核身成功时为 null

RiskInfo 对象说明

RiskInfo 是 SDK 用来给合作方传递刷脸风险信息的对象,在 WbCloudFaceVerifyLoginListener 回调的 WbFaceVerifyResult 对象中作为参数返回给合作方 App。 其中 RiskInfo 对象的各个字段意义如下表所示:
字段名
类型
字段含义
说明
deviceInfoLevel
String
设备风险等级
设备风险级别,如果命中风险则显示
deviceInfoTag
String
设备风险标签
设备风险等级描述
riskInfoLevel
String
身份风险等级
如果命中身份风险则显示风险等级
riskInfoTag
String
身份风险标签
身份风险等级描述

WbFaceError 对象说明

WbFaceError 是 SDK 用来给合作方传递人脸核身错误信息的对象,在 WbCloudFaceVerifyLoginListener 回调和 WbFaceVerifyResult 对象中作为参数返回给合作方 App。WbFaceError 对象的各个字段意义如下表所示,各个字段的内容取值详情请参见 错误码
字段名
类型
字段含义
说明
domain
String
错误发生的阶段
只有当 domain=WBFaceErrorDomainCompareServer 时表示用户完成了刷脸,可以通过接口去拉取刷脸结果。其他 domain 表示用户刷脸中途退出或命中了风控逻辑,后端无法查询到刷脸结果
code
String
错误码
-
desc
String
错误描述
如有需求,可以展示给用户
reason
String
错误信息内容
错误的详细实际原因,主要用于定位问题