一、接入准备
授权指引及接入准备参见 意愿核身微信小程序接入准备。
接入流程参见 意愿核身小程序接入流程 步骤1-3。
二、步骤一：注册并创建 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
示例 demo 下载。