GameRecorderShareButton wx.createGameRecorderShareButton(Object object)

基础库 2.8.0 开始支持，低版本需做兼容处理。

创建游戏对局回放分享按钮，返回一个单例对象。按钮在被用户点击后会发起对最近一次录制完成的游戏对局回放的分享。

参数

Object object

属性类型默认值必填说明
styleObject是按钮的样式
iconstring否图标的 url。支持 http/https 开头的网络资源和 wxfile:// 开头的本地资源。如果不设置则使用默认图标。
imagestring否按钮的背景图片的 url。支持 http/https 开头的网络资源和 wxfile:// 开头的本地资源。如果不设置则使用默认图标。
textstring否按钮的文本。
shareObject是对局回放的分享参数。

object.style 的结构

属性类型默认值必填说明
leftnumber0否左上角横坐标，单位 逻辑像素
topnumber0否左上角纵坐标，单位 逻辑像素
heightnumber40否按钮的高度，最小 40 逻辑像素
iconMarginRightnumber8否图标和文本之间的距离，最小 8 逻辑像素
fontSizenumber17否文本的字体大小。最小 17，最大 22。
colorstring#ffffff否文本的颜色。
paddingLeftnumber16否按钮的左内边距，最小 16 逻辑像素。
paddingRightnumber16否按钮的右内边距，最小 16 逻辑像素。

object.share 的结构

属性类型默认值必填说明
querystring是分享的对局回放打开后跳转小游戏的 query。
titleObject否对局回放的标题。对局回放标题不能随意设置，只能选择预设的文案模版和对应的参数。
buttonObject否对局回放的按钮。只能选择预设的文案模版。
bgmstring是对局回放背景音乐的地址。必须是一个代码包文件路径或者 wxfile:// 文件路径，不支持 http/https 开头的 url。
timeRangeArray.<number>是对局回放的剪辑区间，是一个二维数组，单位 ms（毫秒）。[[1000, 3000], [4000, 5000]] 表示剪辑已录制对局回放的 1-3 秒和 4-5 秒最终合成为一个 3 秒的对局回放。对局回放剪辑后的总时长最多 60 秒，即 1 分钟。

object.share.title 的结构

属性类型默认值必填说明
templatestring否对局回放的标题的模版。不传则为：${用户昵称} 在 ${游戏名称} 的游戏时刻
dataObject否对局回放的标题的模版参数。

object.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 }

object.share.button 的结构

属性类型默认值必填说明
templatestringenter否对局回放的按钮的模版。

object.share.button.template 的合法值

值说明最低版本
enter马上玩
challenge去挑战
play去挑战

返回值

GameRecorderShareButton