# 小程序服务商组件使用指南

# 一、组件介绍

详情请查看小程序服务商组件介绍。

# 二、组件接入流程

# 1. 注册小程序

前往微信公众平台注册小程序，根据指引填写信息并提交相应资料，完成注册流程。若已有小程序，可直接使用。

# 2. 登录微信开放平台，绑定小程序

登录微信开放平台，选择「小程序」，点击「绑定小程序」，按照指引完成小程序绑定。

# 3. 登录开放平台，创建第三方平台

登录微信开放平台，选择「第三方平台」，点击「创建第三方平台」（需选择平台型服务商），按照指引完成第三方平台创建并进入审核流程。审核通过后即可申请开通小程序服务商组件。

注意：如已有第三方平台，可跳过此步骤。

# 4. 登录开放平台，开通小程序服务商组件

登录微信开放平台，前往「第三方平台 - 详情 - 能力申请」，选择「小程序服务商组件」并申请开通功能。

注意：该组件已设置不可通过公众平台添加，只能通过第三方平台的能力申请进行添加。

# 5. 引入小程序服务商组件并开发

在小程序项目中引入小程序服务商组件，参照下方文档接入并开发。建议同时查看插件本身的在线开发文档，以获取最新的文档更新信息。

# 6. 提交审核和发布

完成开发后，提交代码审核，审核通过后即可发布。

# 三、组件使用

# 组件的引用

1）版本限制：基础库版本 2.16.0 及以上

2）组件的 AppID：wxb8b928431b8c56d8

3）需要在项目中引入「小程序服务商组件」，编辑项目根目录的 app.json 文件，示例代码如下：

// 建议使用小程序服务商组件最新版本号，可在微信开发者工具调试时获取
// 复制时请去掉注释
"plugins": {
  "miniprogram-thirdparty-plugin": {
    "version": "2.xx.0",
    "provider": "wxb8b928431b8c56d8" // 必须填小程序服务商组件 AppID，不要修改
  }
}

# 组件使用

# 小程序代码中使用插件（试用小程序场景）

const MiniprogramThirdpartyPlugin = requirePlugin('miniprogram-thirdparty-plugin')

// 初始化
MiniprogramThirdpartyPlugin.init(wx)

// 请求用户授权
MiniprogramThirdpartyPlugin.authorize({
  token: 'createToken', // 传入后台返回的 create_token，通过 fastregisterbetaweapp 接口获得的 authorize_url 中的 create_token
  success(res) {
    // 授权成功
    wx.showToast({
      title: '授权成功',
    })
  },
  fail(err) {
    console.error(err)
    // 授权失败或其他异常
    wx.showToast({
      title: '授权失败',
    })
  }
})

// 请求打开试用小程序
MiniprogramThirdpartyPlugin.openTrial({
  appid: 'appid', // 试用小程序的 AppID
  platformAppID: 'platform_appid', // 平台的 AppID
  fail() {
    // 其他异常
  }
})

# 小程序代码中使用插件（授权场景）

const MiniprogramThirdpartyPlugin = requirePlugin('miniprogram-thirdparty-plugin')

// 初始化
MiniprogramThirdpartyPlugin.init(wx)

// 请求用户授权
MiniprogramThirdpartyPlugin.openAuthorizeAccount({
  platformAppID: '',
  preAuthCode: '', // 获取的预授权码
  authType: 3,
  bizAppid: 'wxxxxxxxxx'
})

注：相关参数说明请查看授权流程技术说明。