本文介绍了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：摄像头无权限或者无法获取摄像头数据出错。