文档中心>人脸核身>含 UI 集成方案>意愿核身>微信小程序>意愿核身 uni-app 小程序接入流程

意愿核身 uni-app 小程序接入流程

最近更新时间:2025-04-25 17:43:22

我的收藏

接入准备

授权指引及接入准备参见 意愿核身微信小程序接入准备
接入流程参见 意愿核身小程序接入流程 步骤1-3。

uni-app接入

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

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

步骤二:下载 SDK

控制台下载最新版本的意愿核身 SDK。

步骤三:并配置 verify_mpsdk

本 SDK 仅支持 uni 微信小程序端。
1. 将 verify-mpsdk 文件夹拷贝到项目根目录的 wxcomponents 文件夹下。
2. 创建一个空页面调用组件。
pages.json 注册组件地址,如pages/verify/index 。
{
"pages": [
...
{
"path": "pages/verify/index",
"style": {
"navigationBarTitleText": "uni-app",
"usingComponents": {
"verify-mp": "/wxcomponents/verify_mpsdk/indexCom"
}
}
}
]
}
在注册的地址生成小程序sdk页,调用verify-mp组件。
注意:
该页面为空内容组件调用页,不需要其他逻辑代码。
<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 包含错误码、错误信息。

卸载 SDK

卸载时删除 verify_mpsdk 文件夹,移除相应代码即可。

示例 demo