1.使用须知

WebRTC 兼容性支持列表

• 在 iOS 14.3 及以上版本，WKWebView 增加了对 WebRTC 的支持。因此，微信、第三方浏览器和 App 需要在 IOS 14.3 及以上版本上才能支持 WebRTC 功能。对于第三方 iOS 端 App，若未使用 WKWebView，则需查看所用的 WebView 是否支持 WebRTC 功能来确定是否支持 WebRTC。

  客户端	Android 版本	iOS 版本	鸿蒙版本
  Edge/Chrome/QQ	Android 8.1 及以上版本大部分支持, 8.1 以下部分支持	iOS 14.3 及以上版本	2.0以上
  Safari 浏览器	不支持	iOS 11 及以上版本	不支持
  UC	Android 9.0 及以上版本	不支持	5.0以下
  UC 极速浏览器	不支持	不支持	不支持
  厂商内置浏览器	大部分机器支持等部分机型支持, 如三星,华为,oppo,vivo, 小米	无	2.0以上
  微信（App）	Android 9.0 及以上版本	iOS 14.3 及以上版本	2.0以上
  App	Android 9.0 及以上版本且使用的 WebView 支持 WebRTC	iOS 14.3 及以上版本且使用 IOS 自带 WKWebView	2.0以上

2.接入流程

2.1 获取 H5 实时活体 URL 与认证单据号

通过活体人脸核身 或活体人脸比对 获取 h5Url 与单据号。

2.2 打开 web 地址

window.location.href=`${h5Url}${h5Url.includes('?') ? '&': '?'}redirectUrl=${encodeURIComponent(redirectUrl)}&certifyId=${certifyId}&token=${token}`

h5Url： 初始化返回 H5 实时活体地址。
redirectUrl： 接收 H5 实时活体返回信息地址,需要用 encodeURIComponent 进行编码。
certifyId： 活体认证唯一单据号。
token： 通过接口认证获取必要的 token 信息。

认证结果接收

`${callbackUrl}?response={code:'${code}',certifyId:'${certifyId}'}`;

说明: response 的内容是 JSON 序列化后并 encodeURIComponent 后的值, 使用时先 decodeURIComponent, 后 JSON.parse 解析后使用。

打开 h5Url 以后，认证结束会通过打开传递的 redirectUrl 参数进行跳转。

2.3 拿到回调结果，通过服务端再次确认结果

错误码code	是否成功	是否计费	描述
00000000	是	是	刷脸完成，实际结果需要通过H5实时活体-获取认证结果进行结果查询
80003612	否	是	活检场景存在风险
80002910	否	否	单个动作超过认证时长
80002915	否	否	活体检测失败
80002902	否	否	回调地址不能为空
80002907	否	否	场景码有误
80002900	否	否	初始化失败
80002901	否	否	单据号不能为空
80002903	否	否	单据号不存在或已过期
80002904	否	否	回调地址有误
80002905	否	否	初始化异常:资源用完
80002908	否	否	单据号已使用，请勿重复初始化
80002927	否	否	动作未做完中断
00006232	否	否	刷脸未完成
00009811	否	否	动作超时
00009814	否	否	动作验证失败
00009800	否	否	摄像头权限拒绝
00009801	否	否	初始化摄像头打开失败
00009803	否	否	缺少输入参数
00009807	否	否	网络错误
00009809	否	否	API请求错误
00009812	否	否	鉴权过期
00009817	否	否	获取方案配置出错
00009818	否	否	用户页面隐藏
00009819	否	否	不支持实时活体
00009820	否	否	IOS系统版本太低, 请升级系统版本
00009821	否	否	打开摄像头超时
00009822	否	否	摄像头打开失败
00009824	否	否	打开摄像头返回错误

2.问题反馈

反馈问题时请附加页面截图/视频、请求入参回参等关键信息。