实人认证开发说明
更新时间:2020-03-13 10:13:55
1 实人认证整体架构
2 实人认证处理流程
3 实人认证SDK适用范围
Android Min Sdk
Version: API 19: Android 4.4 (KitKat)
适用架构:armeabi,
armeabi-v7a, arm64-v8a
4 实人认证SDK下载
创建应用,获取APPKEY,详细操作参见>>
配置SDK,选择实人认证SDK并下载
5 实人认证SDK使用步骤
5.1 app 中正确添加aar
5.2 初始化
iPManager = new IPManager();
//初始化
//public int init(Context context)
//input: context
//成功返回0, 失败返回其他值
ipManager.init(this);
5.3 空发
//获取本地是否存在id2
//public int id2ClientGetProvStat()
//已存在, 返回1, 其他返回0
int state = iPManager.id2ClientGetProvStat();
//生成空发认证码
//public byte[] id2ClientGetOtpAuthCode(byte[] token)
//input: 临时token, base64 编码,从服务端接收到的tmp_token直接传入
//success 返回authcode,需base64编码后上传服务端, failed 返回null
byte[] authcode = iPManager.id2ClientGetOtpAuthCode(tmp_token);
//解析并存储id2
//public int id2ClientLoadOtpData(byte[] otp_data)
//input: otp_data, 从服务端接收到的otp_data需base64 解码后传入
//success 返回0,failed 返回其他值
iPManager.id2ClientLoadOtpData(otp_data) //空发id2
5.4 获取image
//设置listerner 监听getImage 的结果
iPManager.setListener(new IPListener() {
@Override
public void onResult(IPErrorCode errcode, IPResult result) {
//errcode 为IP_SUCCESS 时, result 中为image正确值
}
});
//public void getImage(Context context, final String timestamp)
//input: unix timestamp 单位ms
iPManager.getImage(this, timestamp);
返回结果参数说明
类IPResult
字段 | 含义 |
---|---|
id | Id2 id |
authcode | 验证码 |
token | 加密后的token |
image | 人脸数据 |
类IPErrorCode
字段 | 含义 |
---|---|
IP_SUCCESS | 认证成功 |
IP_FAIL | 认证失败 |
IP_NOT | 认证中断 |
IP_EXCEPTION | 认证异常 |
5.5 调用结束
//调用结束, 与init 配对使用
//public int cleanup()
ret = iPManager.cleanup();
注:使用实人认证sdk时,如果返回错误结果,可使用adb logcat命令过滤标签IDENTIFY_PERSON,TEE,ID2,LS_LOG查看实人认证sdk 相关日志。