# 网站应用拉起 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",
});