本文介绍了PC或移动端H5网页SDK的接入流程。

手机浏览器支持列表

浏览器名称 支持情况
Edge 支持
FireFox 支持
Chrome 支持
Safari 支持( iOS 11及以上)
Opera 支持
Android Browser 5.0+ 支持
UC 支持
QQ 支持
厂商内置浏览器 华为、三星等部分机型支持
说明 受制于浏览器兼容性碎片化问题,建议您在流程设计上引导用户使用推荐的浏览器完成认证。若您是App内集成该方案,可能会因为内嵌浏览器原因无法兼容,推荐您使用SDK模式接入;若您是通过微信的公众号或者小程序集成,基于微信运营审核规则限制,可能出现无法避免的兼容性问题,建议您使用纯服务端(API)接入方式。

扫脸认证

为提升用户刷脸认证体验,ULR默认自带扫脸认证引导页(微信公号号场景下该页面是必须存在的,否则会导致摄像头无法唤起,引发黑屏现象)。若您并非应用在微信场景且已经自主研发了引导页,可通过工单反馈给我们,我们会为您关闭该页面。

引导页

启动刷脸

<script type="text/javascript"src="https://cn-shanghai-aliyun-cloudauth.oss-cn-shanghai.aliyuncs.com/web_sdk_js/jsvm_all.js" ></script>
  1. 引入上述JS文件,调用函数getMetaInfo() 获取MetaInfo。
  2. 您在调用实人认证服务端 发起认证请求时需要传入该MetaInfo值。
  3. 获取服务端初始化返回的CertifyUrl,在浏览器中加载该链接进行实人认证。

结果解析

CertifyUrl中ReturnUrl参数为商户自定义,结果会在扫脸完成后拼接在ReturnUrl后面作为参数返回给商户,格式如下:
response=%7B"code"%3A1001%2C"subCode"%3A"Z5051"%2C"reason"%3A"success"%2C"extInfo"%3A%7B%7D%7D
从URL中获取response参数,URL解码后格式如下:
{
  "code":"",
  "subCode":"",
  "reason":"",
  "extInfo" : {}
}

结果说明

  • 1000:代表刷脸成功,该结果仅供参考,可通过服务端查询认证结果获取最终认证结果。
  • 1001:表示系统错误。
  • 1003:表示验证中断。
  • 2002:表示网络错误。
  • 2003:表示客户端设备时间错误。
  • 2006:表示刷脸失败,如需获取更详细的失败原因,需调用服务端查询认证结果

subCode说明

  • Z5052:数据错误或程序异常。
  • Z5056:重试次数过多。
  • Z5055:用户退出。
  • Z5054:摄像头无权限或者无法获取摄像头数据出错。