人脸识别 - authFace

简介

• 通过该API可拉起APP的人脸识别功能，并返回对应的回调信息；
• 该API是一个异步任务，可使用async await / promise结构 获取回调值；

环境适配说明

环境名称	是否支持	jssdk文件最低版本号	npm包最低版本号
湘易办APP-小程序	✅	1.1.4	0.0.4
湘易办APP-小程序-webview	✅	1.1.8	0.0.4
湘易办APP-webview	✅	2.0.0	0.0.4
三方H5	❌	--	--
三方小程序-H5	✅	--	0.0.32

参数

参数名	类型	必填	描述
name	String	✅	姓名
certNo	String	✅	证件号
appId	String	✅	申请人脸能力的appID
sign	String	✅	签名
created	timestamp	✅	创建时间戳
nonce	String	✅	32位随机数
callbackURL	String	❌	人脸识别后，回跳的页面地址

返回值

仅列出返回体内的子参数，整体是一个Object对象

参数名	类型	描述
isSuccess	Boolean	验证结果
certifyId	String	认证ID
portrait	base64	头像
errorMsg	String	错误信息

示例

async & await 模式

const userInfo = {
  name: '张三',
  certNo: '123456789012345678'
}
const res = await this.$xybAgent.authFace(userInfo);
if (res?.isSuccess) {
  // 执行业务代码
}

promise 模式

const userInfo = {
  name: '张三',
  certNo: '123456789012345678'
}
this.$xybAgent.authFace(userInfo).then(res => {
  if (res?.isSuccess) {
    // 执行业务代码
  }
})