Android 通过 SDK 快速接入腾讯云人脸核身

官方文档：https://cloud.tencent.com/document/product/1007/35866

前期操作就是一系列的申请啊，拿到对应的AppId 和 keyLicence，secret ,没什么要求，就是等待审核，本文就讲代码接入

步骤。

一、申请签名和faceId（文档上说是后台申请，但是你也可以都在Android端搞定）

申请签名需要ticket，申请ticket 需要Access Token.

申请 Access Token：

请求 URL：https://idasc.webank.com/api/oauth2/access_token 请求方法：GET

请求参数：

参数	说明	类型	长度（字节）	是否必填
app_id	请添加小助手微信 faceid001，进行线下对接获取	String	腾讯云线下对接决定	是
secret	请添加小助手微信 faceid001，进行线下对接获取	String	腾讯云线下对接决定	是
grant_type	授权类型，默认值为：client_credential（必须小写）	String	20	是
version	版本号，默认值为：1.0.0	String	20	是

成功响应：

{
"code":"0","msg":"请求成功",
"transactionTime":"20151022043831",
"access_token":"accessToken_string",
"expire_time":"20151022043831",
"expire_in":"7200"
}

申请Ticket

请求 URL：https://idasc.webank.com/api/oauth2/api_ticket 请求方法：GET

请求参数：

参数	说明	类型	长度（字节）	是否必填
app_id	请添加小助手微信 faceid001，进行线下对接获取	String	腾讯云线下对接决定	是
access_token	请根据 Access Token 获取指引进行获取	String	腾讯云线下对接决定	是
type	ticket 类型，默认值：NONCE（必须大写）	String	20	是
version	版本号	String	20	是
user_id	当前使用用户的唯一标识，需合作伙伴自行定义注意：合作伙伴必须保证 user_id 的全局唯一性	String	30	是

响应结果：

{
    "code": "0",
    "msg": "请求成功",
    "transactionTime": "20151022044027",
    "tickets": [{
        "value": "ticket_string",
        "expire_in": "120",
        "expire_time": "20151022044027"
    }]
}

拿到ticket后，就可以生成sign了
生成签名的算法：

（这里用到了Hasing，需要用到guava-28.2-jre.jar链接：https://download.csdn.net/download/qq_39836064/12194244）

public static String sign(List<String> values, String ticket) {
    if (values == null) {
        throw new NullPointerException("values is null");
    }
    values.removeAll(Collections.singleton(null));// remove null
    values.add(ticket);
    java.util.Collections.sort(values);

    StringBuilder sb = new StringBuilder();
    for (String s : values) {
        sb.append(s);
    }
    return Hashing.sha1().hashString(sb, Charsets.UTF_8).toString().toUpperCase();
}

传入参数为：

参数	说明	来源
wbappid	请添加小助手微信 faceid001，进行线下对接获取	腾讯云线下对接分配
userId	用户唯一标识	合作方自行分配（与 SDK 里定义的 userId 保持一致）
version	参数值为：1.0.0	-
ticket	合作伙伴服务端缓存的 ticket，注意是 NONCE 类型	获取方式请参见获取 NONCE ticket（所用的 userId 参数值需要与 SDK 里面定义 userId 值保持一致）
nonceStr	必须是32位随机数	合作方自行生成（与 SDK 里定义的随机数保持一致）

        List<String> values = new ArrayList<String>();
        values.add(wbappid);
        values.add(userId);
        values.add(version);
        values.add(nonceStr);
        String sign = sign(values, ticket);

这时候就拿到sign了，可以去申请faceId了。

生成faceId

请求 URL：https://idasc.webank.com/api/server/getfaceid 请求方法：POST

报文格式：Content-Type: application/json

参数	说明	类型	长度（字节）	是否必填
webankAppId	请添加小助手微信 faceid001，进行线下对接获取	String	腾讯云线下对接决定	是
orderNo	订单号，由合作方上送，每次唯一，不能超过 32 位	String	不能超过 32 位	是
name	姓名	String	-	是
idNo	证件号码	String	-	是
userId	用户 ID ，用户的唯一标识（不能带有特殊字符）	String	-	是
sourcePhotoStr	比对源照片，注意：原始图片不能超过 500k，且必须为 JPG 或 PNG 格式。参数有值：使用合作伙伴提供的比对源照片进行比对，必须注照片是正脸可信照片，照片质量由合作方保证。参数为空：根据身份证号 + 姓名使用权威数据源比对	BASE64String	1048576	否，非必填
sourcePhotoType	比对源照片类型，参数值为1 时是：水纹正脸照。参数值为 2 时是：高清正脸照	String	1	是
version	默认参数值为：1.0.0	String	20	是
sign	签名：使用上面生成的签名	String	40	是

响应：

{
"code": 0,
"msg": "成功",
"result": {
     "bizSeqNo":"业务流水号",
     "orderNo":"合作方订单号",
     "faceId":"cc1184c3995c71a731357f9812aab988"
    }
}

二、Android端接入

添加腾讯云提供的arr 文件

//1. 云刷脸SDK
 compile(name: 'WbCloudFaceLiveSdk-版本号-githash值', ext: 'aar')
 //2. 云normal SDK
 compile(name: 'WbCloudNormal-版本号-githash值', ext: 'aar')

混淆规则

###############云刷脸混淆规则 faceverify-BEGIN##################
#不混淆内部类
-keepattributes InnerClasses

-keep public class com.webank.facelight.tools.WbCloudFaceVerifySdk{
    public <methods>;
    public static final *;
}
-keep public class com.webank. facelight.tools.WbCloudFaceVerifySdk$*{
    *;
}
-keep public class com.webank.record.**{
    public <methods>;
    public static final *;
}
-keep public class com.webank. facelight.ui.FaceVerifyStatus{

}
-keep public class com.webank. facelight.ui.FaceVerifyStatus$Mode{
    *;
}
-keep public class com.webank. facelight.tools.IdentifyCardValidate{
    public <methods>;
}
-keep public class com.tencent.youtulivecheck.**{
    *;
}
-keep public class com.webank. facelight.contants.**{
    *;
}
-keep public class com.webank. facelight.listerners.**{
    *;
}
-keep public class com.webank. facelight.Request.*$*{
    *;
}
-keep public class com.webank. facelight.Request.*{
    *;
}
-keep public class com.webank. facelight.config.FaceVerifyConfig {
    public <methods>;
}

-keep class com.tencent.youtuface.**{
    *;
}
-keep class com.tencent.youtulivecheck.**{
    *;
}
-keep class com.tencent.youtufacetrack.**{
    *;
}
-keep class com.tencent.youtufacelive.model.**{
    *;
}
-keep class com.tencent.youtufacelive.tools.FileUtils{
public <methods>;
}
-keep class com.tencent.youtufacelive.tools.YTUtils{
    public <methods>;
}
-keep class com.tencent.youtufacelive.tools.YTFaceLiveLogger{
    public <methods>;
}
-keep class com.tencent.youtufacelive.tools.YTFaceLiveLogger$IFaceLiveLogger{
     *;
}
-keep class com.tencent.youtufacelive.IYTMaskStateListener{
    *;
}
-keep class com.tencent.youtufacelive.YTPreviewHandlerThread{
    public static *;
    public <methods>;
}
-keep class com.tencent.youtufacelive.YTPreviewHandlerThread$IUploadListener{
     *;
}
-keep class com.tencent.youtufacelive.YTPreviewHandlerThread$ISetCameraParameterListener{
     *;
}
-keep class com.tencent.youtufacelive.YTPreviewMask{
    public <methods>;
}
-keep class com.tencent.youtufacelive.YTPreviewMask$TickCallback{
    *;
}
-keeppackagenames com.webank.mbank.permission_request
# 保留自定义控件(继承自View)不能被混淆
-keep public class * extends android.view.View {
    public <init>(android.content.Context);
    public <init>(android.content.Context, android.util.AttributeSet);
    public <init>(android.content.Context, android.util.AttributeSet, int);
    public void set*(***);
    *** get* ();
}
################云刷脸混淆规则 faceverify-END########################

#############webank normal混淆规则-BEGIN###################
#不混淆内部类
-keepattributes InnerClasses
-keepattributes *Annotation*
-keepattributes Signature

-keep, allowobfuscation @interface com.webank.normal.xview.Inflater
-keep, allowobfuscation @interface com.webank.normal.xview.Find
-keep, allowobfuscation @interface com.webank.normal.xview.BindClick

-keep @com.webank.normal.xview.Inflater class *
-keepclassmembers class * {
    @com.webank.normal.Find *;
    @com.webank.normal.BindClick *;
}

-keep public class com.webank.normal.net.*$*{
    *;
}
-keep public class com.webank.normal.net.*{
    *;
}
-keep public class com.webank.normal.thread.*$*{
   *;
}
-keep public class com.webank.normal.thread. *{
   *;
}
-keep public class com.webank.normal.tools.WLogger{
    *;
}
-keep public class com.webank.normal.tools.*{
*;
}

#wehttp混淆规则
-dontwarn com.webank.mbank.okio.**

-keep class com.webank.mbank.wehttp.**{
    public <methods>;
}
-keep interface com.webank.mbank.wehttp.**{
    public <methods>;
}
-keep public class com.webank.mbank.wehttp.WeLog$Level{
    *;
}
-keep class com.webank.mbank.wejson.WeJson{
    public <methods>;
}
-keep public class com.webank.mbank.wehttp.WeReq$ErrType{ 
     *;
}
#webank normal包含的第三方库bugly
-keep class com.tencent.bugly.webank.**{
    *;
}
###########webank normal混淆规则-END#######################
########云产品依赖的第三方库 混淆规则-BEGIN############

## support:appcompat-v7
-keep public class android.support.v7.widget.** { *; }
-keep public class android.support.v7.internal.widget.** { *; }
-keep public class android.support.v7.internal.view.menu.** { *; }

-keep public class * extends android.support.v4.view.ActionProvider {
    public <init>(android.content.Context);
}

#########云产品依赖的第三方库 混淆规则-END#############

调用SDK所需参数

参数	说明	类型	长度（字节）	是否必填
faceId	刷脸 ID 号，由合作方向人脸识别后台拉取获得	String	-	是
agreementNo	订单号，合作方订单的唯一标识	String	32	是
openApiAppId	腾讯云线下对接分配的 AppID	String	腾讯云线下对接决定	是
openApiAppVersion	接口版本号，默认填：1.0.0	String	20	是
openApiNonce	与服务端生成签名的随机数保持一致	String	32	是
openApiUserId	User Id，每个用户唯一的标识，和服务端保持一致	String	30	是
openApiSign	第一步中通过 ticket 计算出来的签名信息	String	40	是
verifyMode	人脸核身类型光线活体：FaceVerifyStatus.Mode.REFLECTION 动作活体是：FaceVerifyStatus.Mode.ACT 数字活体是：FaceVerifyStatus.Mode.NUM	FaceVerifyStatus.Mode	-	是
keyLicence	腾讯云线下对接分配的 Licence	String	腾讯云线下对接决定	是

用自己的数据调用腾讯云SDK提供的接口

# 在MainActivity中单击某个按钮的代码逻辑：
//先填好数据 
Bundle data = new Bundle();
WbCloudFaceVerifySdk.InputData inputData = new WbCloudFaceVerifySdk.InputData(
                faceId,
                agreementNo,
                openApiAppId,
                openApiAppVersion,
                openApiNonce,
                userId,
                userSign,
                verifyMode,
                keyLicence);
  data.putSerializable(WbCloudFaceContant.INPUT_DATA, inputData);

  //个性化参数设置,可以不设置，不设置则为默认选项。
  //是否显示成功结果页，默认显示，此处设置为不显示
  data.putBoolean(WbCloudFaceContant.SHOW_SUCCESS_PAGE, false);
  //是否展示刷脸失败页面，默认展示,此处设置为不显示
  data.putBoolean(WbCloudFaceContant.SHOW_FAIL_PAGE, false);
//sdk样式设置，默认为黑色
//此处设置为白色
  data.putString(WbCloudFaceContant.COLOR_MODE, WbCloudFaceContant.WHITE);

//设置选择的比对类型  默认为权威库网纹图片比对
//权威数据源比对 WbCloudFaceContant.ID_CRAD
//自带比对源比对  WbCloudFaceContant.SRC_IMG
//仅活体检测  WbCloudFaceContant.NONE
//此处设置权威数据源对比
  data.putString(WbCloudFaceContant.COMPARE_TYPE, WbCloudFaceContant.ID_CRAD);
//是否需要录制上传视频 默认需要，此处设置为需要 
  data.putBoolean(WbCloudFaceContant.VIDEO_UPLOAD, true);
  //是否对录制视频进行检查,默认不检查，此处设置为不检查
  data.putBoolean(WbCloudFaceContant.VIDEO_CHECK, false);
  //设置是否打开闭眼检测，默认不检测,此处设置为检测
  data.putBoolean(WbCloudFaceContant.ENABLE_CLOSE_EYES, true);
//设置是否打开语音提示，默认打开，此处设置为关闭
  data.putBoolean(WbCloudFaceContant. PLAY_VOICE, false);

//初始化 SDK，得到是否登录 SDK 成功的结果 
WbCloudFaceVerifySdk.getInstance().initSdk(
  MainActivity.this,
  data,a
  //由WbCloudFaceVerifyLoginListener返回登录结果
  new WbCloudFaceVerifyLoginListener() {
            @Override
            public void onLoginSuccess() {
             //登录成功，拉起sdk页面
  WbCloudFaceVerifySdk.getInstance().startWbFaceVerifySdk (MainActivity.this,
new WbCloudFaceVerifyResultListener() {
     //由FaceVerifyResultListener返回刷脸结果
       @Override
public void onFinish(WbFaceVerifyResult result) { 
    if(result != null) {
         if (result.isSuccess()) {
              Log.d(TAG, "刷脸成功！");
           } else {
              Log.d(TAG, "刷脸失败！);
           }
         }
      });
    }
            @Override
            public void onLoginFailed(WbFaceError error) {
              //登录失败
              ...
         }

响应结果

字段名	类型	字段含义	说明
isSuccess	boolean	人脸核身是否成功	-
sign	String	签名	供 App 校验人脸核身结果的安全性
liveRate	String	活体检测分数	-
similarity	String	人脸比对分数	“仅活体检测” 类型不提供此分数
userImageString	String	用户人脸核身图片	经过 Base64 编码后的用户人脸核身图片，仅用户成功通过验证时返回
WbFaceError	自定义对象	人脸核身错误	人脸核身成功时为 null

错误响应

字段名	类型	字段含义	说明
domain	String	错误发生的阶段	-
code	String	错误码	-
desc	String	错误描述	如有需求，可以展示给用户
reason	String	错误信息内容	错误的详细实际原因，主要用于定位问题

Android 快速接入腾讯云人脸核身（识别）

Android 通过 SDK 快速接入腾讯云人脸核身

一、申请签名和faceId（文档上说是后台申请，但是你也可以都在Android端搞定）

二、Android端接入

如何基于surging跨网关跨语言进行缓存降级

2024合集

程序员天天 CURD，怎么才能成长，职业发展的思考(2)

移位操作搞定两数之商

教你用Perl实现Smgp协议

如何通过前端表格控件在10分钟内完成一张分组报表？

win11关闭自动检测病毒删文件

通用代码生成器简介

lightdb 单机模式下数据库平移

千兆宽带实际网速能到达多少？

Android 常用第三方框架一些有趣的文章自我整理

Java使用Poi進行excel的文件導出，下載

Android 淘寶19年雙十一自動化做任務

騰訊雲人臉核身，拉起SDK後無法識別人臉問題

Android 快速接入騰訊雲人臉核身（識別）

https://yachay.unat.edu.pe/blog/index.php?comment_area=format_blog&comment_component=blog&comment_co

linux以太網驅動總結

Android 快速接入腾讯云人脸核身（识别）

Android 通过 SDK 快速接入腾讯云人脸核身

一 、申请签名和faceId（文档上说是后台申请，但是你也可以都在Android端搞定）

二 、Android端接入

一、申请签名和faceId（文档上说是后台申请，但是你也可以都在Android端搞定）

二、Android端接入