GameRecorderShareButton
游戏对局回放分享按钮。按钮在被用户点击后会发起对最近一次录制完成的游戏对局回放的分享。
按钮的样式
string icon
图标的 url。支持 http/https 开头的网络资源和 wxfile:// 开头的本地资源。如果不设置则使用默认图标。
string image
按钮的背景图片的 url。支持 http/https 开头的网络资源和 wxfile:// 开头的本地资源。如果不设置则使用默认图标。
Object share
对局回放的分享参数。
属性 | 类型 | 说明 |
---|---|---|
query | string | 分享的对局回放打开后跳转小游戏的 query。 |
title | Object | 对局回放的标题的配置。对局回放标题不能随意设置,只能选择预设的文案模版和对应的参数。 |
button | Object | 对局回放的按钮的配置。对局回放按钮的文案不能随意设置,只能选择预设的文案模版。 |
bgm | string | 对局回放背景音乐的地址。必须是一个代码包文件路径或者 wxfile:// 文件路径,不支持 http/https 开头的 url。 |
timeRange | Array.<number> | 对局回放的剪辑区间,是一个二维数组,单位 ms(毫秒)。[[1000, 3000], [4000, 5000]] 表示剪辑已录制对局回放的 1-3 秒和 4-5 秒最终合成为一个 3 秒的对局回放。对局回放剪辑后的总时长最多 60 秒,即 1 分钟。 |
share.title 的结构
share.title.template 的合法值
值 | 说明 | 最低版本 |
---|---|---|
defautl.score | 模版格式为,《小游戏名称》,本局得分:${score},对应的 data 应该如 { score: 4500 } | |
default.level | 模版格式为,《小游戏名称》,当前关卡:第42关,对应的 data 应该如 { level: 23 } | |
default.opponent | 模版格式为,《小游戏名称》,本局对手:${opponent},对应的 data 应该如 { opponent_openid: 'oC6J75Sh1_4K8Mf5b1mlgDkMPhoI' } | |
default.cost | 模版格式为,《小游戏名称》,本局耗时:${cost}秒,对应的 data 应该如 { cost_seconds: 123 } |
share.button 的结构
值 | 说明 | 最低版本 |
---|---|---|
enter | 马上玩 | |
challenge | 去挑战 | |
play | 去挑战 |
方法
GameRecorderShareButton.show()
显示游戏对局回放分享按钮
隐藏游戏对局回放分享按钮
GameRecorderShareButton.onTap(function callback)
监听游戏对局回放分享按钮的点击事件。只有当分享由于非用户取消的原因失败时,该事件的回调函数才会执行。
GameRecorderShareButton.offTap(function callback)
取消监听游戏对局回放分享按钮的点击事件