# 定向分享

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

** 基础库最低版本: 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 是否设置成功