# 分享
# 启用分享按钮(被动分享)
# 接口说明
用于启用游戏右上角•••菜单中的分享按钮,并同步设置其点击时的分享参数;建议在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通讯录
| |
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
}
});