# 网站应用分享 PC 小程序

**注意：「分享小程序」功能已经升级为「发送给朋友」和「分享到朋友圈」，支持不止小程序的分享，还支持图片和 H5 网页的分享，建议开发者 [按照文档](share) 使用新的分享能力。**

## 1、功能介绍

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

网站应用接入此功能后，微信 4.0.1 for Mac 或者微信 4.0.1 for Windows 及以上版本的用户，可以将网站应用内容以小程序卡片的形式分享给微信会话。

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

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

## 2、分享 PC 端小程序的规则

- 发起分享的网站应用与小程序属于同一微信开放平台账号
- 支持分享 PC 小程序类型消息至会话，暂不支持分享至朋友圈

## 3、分享 PC 小程序接口调用方式

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

接口名：`wxopensdk.shareMiniProgram`

参数：

| 名称 | 是否必填 | 格式 | 描述 |
| :--- | :--- | :--- | :--- |
| appid | 是 | string | 当前网站应用的 appid，非小程序的 AppID |
| userName | 是 | string | 需要分享的小程序的原始 id |
| txt | 是 | string | 分享卡片的标题名称 |
| thumburl | 是 | string | 分享卡片的图片地址，注意为必填。图片建议长宽比是 5:4。 |
| path | 否 | string | 分享 PC 小程序的启动路径，默认空 |
| ticket | 是 | string | 通过后台接口获取的单次调用 ticket |
| timeout | 否 | number | 微信未登录时尝试拉起微信调用接口的超时时间，单位 ms，允许 0-60000，默认 30000。若微信已登录不受该参数的影响。若设置为 0 则不会尝试拉起微信。 |

示例：

```javascript
wxopensdk.shareMiniProgram({
  appid: "wxd930ea5d5a258f4f",
  userName: "gh_d43f693ca31f",
  txt: "示例标题",
  path: "",
  thumburl:
    "https://sticker.weixin.qq.com/htdocs/zh_CN/images/index/register_3.2x47d04f.png",
  ticket: "84_5JjOIqRU8dUjR3wVGA0_rdF0UdgvdiFZIyxi8qTaDBuann5POOKAzjbwtmE",
});
```
