微信小程序 uni-app 接入流程

最近更新时间:2025-01-09 17:52:53

我的收藏

接入准备

授权指引及接入准备参见 微信小程序接入指引
小程序前端接口请求有域名白名单限制,如果不添加只能再调试模式下运行,上线前需要将如下两个域名在小程序后台添加服务器域名。
https://faceid.qq.com;
https://faceid.qcloud.com;

uni-app接入

步骤一:注册并创建 uni-app 开发环境

uni-app 开发接入具体参照 uni官网

步骤二:下载 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: '', // 必要参数,BizToken
startPath: '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