实人认证开发说明

更新时间:2020-03-13 10:13:55

1 实人认证整体架构

image.png

2 实人认证处理流程

image.png

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 相关日志。

参考资料

results matching ""

    No results matching ""