# 网站应用分享内容到 PC 微信

# 1、功能介绍

为方便网站应用将优质内容分享至微信,平台开放提供 PC OpenSDK 能力,支持网站应用分享内容(小程序、网页以及图片)到 PC 微信会话及朋友圈。

网站应用接入此功能后,微信 4.0.7 for Mac 或者微信 4.0.7 for Windows 及以上版本的用户,即可支持从网站应用分享内容到 PC 微信。

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

  • 对于此前已配置了业务域名且审核通过的网站应用,开发者只需重新进入业务域名编辑页重新提交,符合条件即可获得【发送给朋友】和【分享到朋友圈】能力权限。
  • 对于尚未完成业务域名配置的审核已通过网站应用,需按照要求配置业务域名后才可获得【发送给朋友】和【分享到朋友圈】能力权限。

# 2、准备工作

  • 创建网站应用并且提交审核,待审核通过
  • 配置业务域名,详情可查看网站应用业务域名配置
  • 然后,申请开通「发送给朋友」和「分享到朋友圈」权限:开发者需前往微信开发者平台绑定网站应用后,前往「网站应用 - 开放能力 - 发送给朋友或分享到朋友圈」申请开通这两项能力。

# 3、接口调用说明

# 3.1 分享小程序至 PC 微信接口调用方式

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

接口名: wxopensdk.shareMiniProgram

参数:

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

示例:

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

# 3.2 分享链接至 PC 微信接口调用方式

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

接口名: wxopensdk.shareLink

参数:

名称 是否必填 格式 描述
appid string 当前网站应用的 appid,非小程序的 AppID
txt string 分享链接的标题名
desc string 分享链接的描述名
thumburl string 分享链接的缩略图地址,注意为必填。
url string 分享 PC 小程序的启动路径,默认空
source string 分享到的目标场景,"chat" 为聊天会话,"timeline" 为朋友圈,默认 "chat"
ticket string 通过后台接口获取的单次调用 ticket
timeout number 微信未登录时尝试拉起微信调用接口的超时时间,单位 ms,允许 0-60000,默认 30000。若微信已登录不受该参数的影响。若设置为 0 则不会尝试拉起微信。

示例:

wxopensdk.shareLink({
  url: "分享链接",
  txt: "标题",
  desc: "卡片的描述",
  appid: "网站应用 appid",
  thumburl: "缩略图url",
  source: "chat", // "timeline" 朋友圈
  ticket: "后台获取的ticket",
});

# 3.3 分享图片至 PC 微信接口调用方式

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

接口名: wxopensdk.shareImage

参数:

名称 是否必填 格式 描述
appid string 当前网站应用的 appid,非小程序的 AppID
imageUrl string 分享的图片 url,最大 10mb。
source string 分享到的目标场景,"chat" 为聊天会话,"timeline" 为朋友圈,默认 "chat"
ticket string 通过后台接口获取的单次调用 ticket
timeout number 微信未登录时尝试拉起微信调用接口的超时时间,单位 ms,允许 0-60000,默认 30000。若微信已登录不受该参数的影响。若设置为 0 则不会尝试拉起微信。

示例:

wxopensdk.shareImage({
  imageUrl: "分享图片 url",
  appid: "网站应用 appid",
  source: "chat", // "timeline" 朋友圈
  ticket: "后台获取的 ticket",
});