定向分享

提供给定向分享能力,支持用户在小程序内向指定好友发起分享。

** 基础库最低版本: 1.17.0

相关接口:

  • 定向分享:open-type=shareMessageToFriend 的<button>组件 (Tips: 该组件仅能在自定义开放数据域组件中使用)
  • 主域监听定向分享结果:qq.onShareMessageToFriend
  • 主域设置定向分享参数:qq.setMessageToFriendQuery

使用 open-type=shareMessageToFriend 的<button>组件,用户点击按钮会自动触发定向分享,具体参数:

属性名 类型 默认值 说明
open-type String QQ 开放能力,定向分享填 shareMessageToFriend
share-message-friend-info FriendInfo 发送对象的 FriendInfo
share-message-title String 转发标题,不传则默认使用当前小程序的昵称。
share-message-img String 转发显示图片的链接,可以是网络图片路径(仅 QQ CDN 域名路径)或本地图片文件路径或相对代码包根目录的图片文件路径。显示图片长宽比是 5:4

FriendInfo 对象

属性 类型 说明
openid string 用户的 openid
avatarUrl string 用户的 QQ 头像 url
nickname string 用户的 QQ 昵称

boolean qq.onShareMessageToFriend(function callback)

在主域监听定向分享结果

callback 回调函数参数

属性 类型 说明
success boolean 是否成功
errMsg string 错误信息

boolean qq.setMessageToFriendQuery(Object object)

设置 qq.shareMessageToFriend 接口 query 字段的值

参数

#Object object

属性 类型 默认值 必填 说明
shareMessageToFriendScene number 需要传递的代表场景的数字,需要在 0 - 50 之间

返回值

boolean 是否设置成功