转发
用户在使用小游戏过程中,可转发消息给其他用户或群聊。
转发菜单
点击右上角按钮,会弹出菜单,菜单中的“转发”选项默认不展示。通过 bl.showShareMenu() 和 bl.hideShareMenu() 可动态显示、隐藏这个选项。
被动转发
用户点击右上角菜单中的“转发”选项后,会触发转发事件,如果小游戏通过 bl.onShareAppMessage() 监听了这个事件,可通过返回自定义转发参数来修改转发卡片的内容,否则使用默认内容。
bl.onShareAppMessage(function () {
// 用户点击了“转发”按钮
return {
title: '转发标题'
}
})
主动转发
游戏内可通过 bl.shareAppMessage()接口直接调起转发界面,与被动转发类似,可以自定义转发卡片内容。
bl.shareAppMessage({
title: '转发标题'
})
使用 Canvas 内容作为转发图片
如果希望转发的时候显示 Canvas 的内容,可以使用 Canvas.toTempFilePath() 或 Canvas.toTempFilePathSync() 来生成一张本地图片,然后把图片路径传给 imageUrl
参数。
转发出来的消息卡片中,图片的最佳显示比例是 5:4。
bl.onShareAppMessage(function () {
return {
title: '转发标题',
imageUrl: canvas.toTempFilePathSync({
destWidth: 500,
destHeight: 400
})
}
})
分享至动态支持大卡片
暂未开放,敬请期待
开发者可去 开发者后台--基本设置 设置动态分享的图片和文案,设置成功后,用户在分享至动态时会使用设置的图片和文案,使查看动态的用户更好的感知分享的小游戏。
开发者后台设置,示例图如下:
点击编辑,可进入动态分享专用设置弹框,进行设置,示例图如下:
设置成功后,动态显示示例图如下:
注意事项
- 对于网络图片的转发,目前只支持
bilibili.com
域下的图片。非bilibili.com
域下的图片,分享将会显示小游戏的logo。 - 如果不指定转发图片,默认会显示一个小游戏的 logo。
- 开发者一旦设置动态分享的图片和文案后,不可撤销。