接入准备
uni-app接入
步骤一:注册并创建 uni-app 开发环境
步骤二:下载 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: '', // 必要参数,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 包含错误码、错误信息。
卸载 SDK
卸载时删除 verify_mpsdk 文件夹,移除相应代码即可。
示例 demo