接入准备
小程序前端接口请求有域名白名单限制,如果不添加只能再调试模式下运行,上线前需要将如下两个域名在小程序后台添加服务器域名。
https://faceid.qq.com;https://faceid.qcloud.com;
uni-app接入
步骤一:注册并创建 uni-app 开发环境
步骤二:下载 SDK
控制台下载最新版本的 SDK。
步骤三:并配置 verify_mpsdk
本 SDK 仅支持 uni 微信小程序端。
1. 将 verify-mpsdk 文件夹拷贝到项目根目录的 wxcomponents 文件夹下。
2. 创建一个空页面调用组件。
pages.json 注册组件:
{"pages": [...{"path": "pages/verify/index","style": {"navigationBarTitleText": "uni-app","usingComponents": {"verify-mp": "/wxcomponents/verify_mpsdk/indexCom"}}}]}
在注册的页面地址调用小程序 SDK 组件:
<template><verify-mp></verify-mp></template><script>export default {data() {return { }},onLoad() {},methods: {},}</script>
3. 初始化。
方法一:可以在 App.vue 中全局初始化。
export default {onLaunch: function() {const verify = require('/wxcomponents/verify_mpsdk/main');verify.init();},};
方法二:在需要调用到的页面方法之前初识化即可。
4. 调用 startVerify。
注意:
startVerify 调用需要在 init 初始化之后。
wx.startVerify({data: {token: '', // 必要参数,BizTokenstartPath: 'pages/verify/index' // 必要参数,配置了verify核身组件的页面地址},success: (res) => { // 验证成功后触发// res 包含验证成功的token, 这里需要加500ms延时,防止iOS下不执行后面的逻辑// 验证成功后,拿到token后的逻辑处理,具体以客户自身逻辑为准},fail: (err) => { // 验证失败时触发// err 包含错误码,错误信息,弹窗提示错误}});
基本 API 描述
Verify.init(options):初始化插件。
options:Object required 初始化的参数。
wx.startVerify(options):进入实名认证页面。
options:Object required 初始化的参数。
options.data.startPath:组件初始化页面,必填。
options.data.token:String required 客户后端调用 DetectAuth 接口获取的 BizToken。
options.success:Function(res) required 验证成功的回调。res 包含验证成功的 token。
options.fail:Function(err) required 验证失败的回调。err 包含错误码、错误信息。
获取实名核身结果信息
用户完成人脸核身后,页面会跳转到 RedirectUrl 上,地址中会带上此次验证流程使用的 BizToken,您在服务端即可凭借 BizToken 参数调用 获取实名核身结果信息 接口去获取本次核身的详细信息。获取到用户验证过程数据,包括文本信息、识别分数、照片和视频。也可以通过访问 腾讯云人脸核身控制台 查看服务调用情况。
卸载 SDK
卸载时删除 verify_mpsdk 文件夹,移除相应代码即可。
示例 demo