# 网站应用拉起 PC 小程序

# 1、功能介绍

考虑到部分场景下网站应用需要通过小程序来承载服务,为此提供 PC OpenSDK ,支持网站应用拉起 PC 端小程序。

网站应用接入此功能后,在微信 3.9.12 for Windows 及以上版本 与 微信 4.0.0 for Mac 及以上版本的用户,可以在网站应用中跳转至 PC 微信客户端某一小程序的指定页面。

目前该功能正在灰度测试中。开发者在微信开放平台账号下申请网站应用、登记业务域名并通过审核且获得拉起 PC 小程序权限后,即获得网站应用拉起 PC 小程序功能权限。当网站应用在已登记的业务域名发起请求时,如果用户此时在 Windows / Mac 设备已经登录了符合要求的微信客户端,且处于非锁定状态,会使用当前账号拉起 PC 端小程序。

  • 对于此前已配置了业务域名且审核通过的网站应用,开发者只需重新进入业务域名编辑页重新提交,符合条件即可获得「拉起 PC 小程序」能力权限
  • 对于尚未完成业务域名配置的审核已通过网站应用,需按照要求配置业务域名后才可获得「拉起 PC 小程序」能力权限

# 2、拉起 PC 端小程序的跳转规则

对于已通过认证的开放平台账号,其网站应用可以跳转至任何合法的小程序,且除 PC OpenSDK 自身的频率限制外,不限制跳转的小程序数量。 对于未通过认证的开放平台账号,其网站应用仅可以跳转至同一开放平台账号下小程序。

# 3、拉起 PC 小程序接口调用方式

请先接入 PC OpenSDK 后调用此接口。

接口名: wxopensdk.launchMiniProgram

参数:

名称 是否必填 格式 描述
appid string 当前网站应用的 appid,非小程序的 AppID
userName string 需要拉起的小程序的原始 id
path string 小程序的启动路径,默认空(会启动首页)
ticket string 通过后台接口获取的单次调用 ticket
timeout number 微信未登录时尝试拉起微信调用接口的超时时间,单位 ms,允许 0-60000ms,默认 30000ms。若微信已登录不受该参数的影响。若设置为 0ms 则不会尝试拉起微信。

示例:

wxopensdk.launchMiniProgram({
  appid: "wxd930ea5d5a258f4f",
  userName: "gh_d43f693ca31f",
  path: "",
  ticket: "84_5JjOIqRU8dUjR3wVGA0_rdF0UdgvdiFZIyxi8qTaDBuann5POOKAzjbwtmE",
});