# 网站应用拉起 PC 小程序

## 1、功能介绍

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

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

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

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

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

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

对于未通过认证的开放平台账号，其网站应用仅可以跳转至同一开放平台账号下小程序。

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

请先接入 [PC OpenSDK](guideline) 后调用此接口。

接口名：`wxopensdk.launchMiniProgram`

参数：

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

示例：

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