# 分享

# 启用分享按钮(被动分享)

# 接口说明

用于启用游戏右上角•••菜单中的分享按钮,并同步设置其点击时的分享参数;建议在SDK初始化完成后立即调用此接口进行设置。

sdkInstance.setShare(options);

# 参数说明

参数说明如下表所示:

选项 类型 必填 默认值 说明
title string -- 分享时显示的标题,不填时默认使用当前游戏的名称
imageUrl string -- 分享时显示的图片链接,可以是网络图片路径,或本地图片文件路径,亦或相对代码包根目录的图片文件路径,建议长宽比为 5:4,不填时默认使用当前游戏的ICON图标
query object -- 分享时携带的额外参数;点击分享消息进入游戏后,可通过 sdkInstance.launchOptions.query 或调用QQ原生方法 qq.getLaunchOptionsSync() 获取该信息

# 示例代码

注:示例代码中的参数或选项均为演示数据,仅供参考,谢谢!

sdkInstance.setShare({
  title: "分享标题,可填写游戏名称",
  imageUrl: "xxxxxxxxxx",
  query: {
    param1: 1,
    param2: 2
  }
});

# 主动分享

# 接口说明

用于主动唤起QQ通讯录列表选择好友进行分享。

sdkInstance.share(options);

# 参数说明

参数说明如下表所示:

选项 类型 必填 默认值 说明
title string -- 分享时显示的标题
imageUrl string -- 分享时显示的图片链接,可以是网络图片路径,或本地图片文件路径,亦或相对代码包根目录的图片文件路径,建议长宽比为5:4
shareAppType string qq

转发目标类型, 不填时默认唤起QQ通讯录

  • qq - 转发给QQ通讯录好友
  • qzone - 转发至QQ空间
  • wechatFriends - 转发给微信好友
  • wechatMoment - 转发至微信朋友圈
  • qqFastShare - 快速转发至来源的聊天窗口
  • qqFastShareList - 快速转发列表
entryDataHash string -- 只有设置该参数,才支持快速分享
query object -- 分享时携带的额外参数;点击分享消息进入游戏后,可通过 sdkInstance.launchOptions.query 或调用QQ原生方法 qq.getLaunchOptionsSync() 获取该信息

快速分享:直接将游戏分享到来源的聊天窗口,不需要经过选择好友的步骤,如果 sdkInstance.launchOptions 启动参数中(亦或调用QQ原生方法 qq.getLaunchOptionsSync()qq.onShow() 的回调函数返回值中)带有 entryDataHash 参数,说明支持快速分享;如果开发者要进行快速分享,需要在 sdkInstance.share(options) 接口的分享参数带上 entryDataHash

# 示例代码

注:示例代码中的参数或选项均为演示数据,仅供参考,谢谢!

sdkInstance.share({
  title: "分享标题,可填写游戏名称",
  imageUrl: "xxxxxxxxxx",
  query: {
    param1: 1,
    param2: 2
  }
});
Last Updated: 2024/8/21 16:53:59