插件集成说明

申请插件

在开始开发前，需要先申请契约锁小程序插件的使用权限，开发者需要登录自身小程序管理后台，在”设置-第三方服务-插件管理“中添加小程序插件，通过如下appId：wxaf8f505686ddf66a，匹配到插件后添加即可提交申请。

引入插件

使用插件前，使用者要在 app.json 中声明契约锁小程序插件（version见插件更新记录中最新版本号），即：

{
  ...
  "plugins": {
    "qyssdk-plugin": {
      "version": "1.2.2",
      "provider": "wxaf8f505686ddf66a"
    }
  }
  ...
}

插件调用方法

契约锁小程序插件以插件页面的形式为对接方小程序提供服务，可通过如下方式进入插件页面，用户在插件页面完成对应操作后，会自动跳回到跳转前的小程序页面，也支持指定跳转页面。

let eventChannel = null;
wx.navigateTo({
    url: `plugin://qyssdk-plugin/${page}?ticket=${ticket}&env=${env}&hasCb=true`,
    events: {
        signSuccessCb: () => { // 签署成功回调
            console.log('signComplete');
            const url = '/pages/bbb/bbb'; // 需要跳转的小程序页面地址，必须是绝对路径，可不传
            eventChannel.emit('jumpTo', url); // 触发跳转逻辑，回调存在时必需调用，url不传默认返回
        },
        authSuccessCb() { // 认证成功回调
            console.log('authSuccess');
            eventChannel.emit('jumpTo');
        },
        authFailCb() { // 认证失败回调
            console.log('authFail');
            eventChannel.emit('jumpTo');
        },
    },
    success(res) {
        eventChannel = res.eventChannel;
    },
});

1.0.23新增：支持调用方小程序自定义跳转

应用示例：实名认证完成，跳转到填参页面

let eventChannel = null;
wx.navigateTo({
    url: `plugin://qyssdk-plugin/${page1}?ticket=${ticket1}&env=${env1}&hasCb=true`,
    events: {
        signSuccessCb: () => {
            eventChannel.emit('jumpTo', '/tabbar/home/home');
        },
        authSuccessCb: () => {
            eventChannel.emit('jumpTo', `plugin://qyssdk-plugin/${page2}?ticket=${ticket2}&env=${env2}&hasCb=true`, {
                signSuccessCb: (openedEventChannel) => {
                    openedEventChannel.emit('jumpTo', `plugin://qyssdk-plugin/${page3}?ticket=${ticket3}&env=${env3}&hasCb=true`);
                },
                authSuccessCb: (openedEventChannel) => {
                    openedEventChannel.emit('jumpTo', '/tabbar/mine/mine');
                },
                authFailCb: (openedEventChannel) => {
                    openedEventChannel.emit('jumpTo', '/subpackages/mine/settings');
                },
            });
        },
        authFailCb: () => {
            eventChannel.emit('jumpTo', '/subpackages/list/list');
        },
    },
    success(res) {
        eventChannel = res.eventChannel;
    },
});

1.0.30新增：支持直接传入成功或失败的跳转地址 ps: 用于修复eventChanel丢失导致无法触发回调（如在插件中，从签署跳到了认证，此时OpenerEventChannel是上一个插件页面，与宿主小程序无法进行通信了）

wx.navigateTo({
    url: `plugin://qyssdk-plugin/${page1}?ticket=${ticket1}&env=${env1}&hasCb=true`,
    success(res) {
        const eventChannel = res.eventChannel;
        // 不传、undefined、null则沿用旧逻辑，空字符串不做任何处理
        eventChannel.emit('sendNavigatePaths', {
            success: '/pages/success', // 成功时跳转的地址，不区分签署页面或者实名认证页面。可传tab页面
            fail: '/pages/fail',
        });
    },
}

参数说明

插件入口与令牌对应说明

此处仅申明不同的插件页面入口，对应的令牌获取接口地址，具体接口请求内容，参考具体接口文档。