bl.createGameRecorderShareButton(Object object)
基础库 3.7.0 开始支持,低版本需做兼容处理
创建游戏对局回放分享按钮,返回⼀个单例对象。按钮在被⽤户点击后会发起对最近⼀次录制完成的游戏对局回放的分享
参数
Object object
| 属性 | 类型 | 默认值 | 必填 | 说明 |
|---|---|---|---|---|
| type | string | text | 否 | 按钮的类型 |
| text | string | 分享回放 | 否 | 按钮上的⽂本,仅当 type 为 text 时有效 |
| image | string | '' | 否 | 按钮的背景图⽚,仅当 type 为 image 时有效 |
| style | Object | {} | 否 | 按钮的样式 |
| share | Object | 是 | 对局回放的分享参数 |
object.type 的合法值
| 值 | 说明 |
|---|---|
| text | 可以设置背景⾊和⽂本的按钮 |
| image | 只能设置背景贴图的按钮,背景贴图会直接拉伸到按钮的宽⾼ |
object.style 的结构
| 属性 | 类型 | 默认值 | 必填 | 说明 |
|---|---|---|---|---|
| left | number | 0 | 否 | 左上角横坐标,单位 逻辑像素 |
| top | number | 0 | 否 | 左上角纵坐标,单位 逻辑像素 |
| height | number | 40 | 否 | 按钮的高度,最小 40 逻辑像素 |
| color | string | #ffffff | 否 | 文本的颜色。 |
| backgroundColor | string | 透明 | 否 | 背景颜⾊(hex 颜⾊代码) |
| borderColor | string | 透明 | 否 | 边框颜⾊(hex 颜⾊代码) |
| borderWidth | number | 0 | 否 | 边框宽度 |
| borderRadius | number | 0 | 否 | 边框圆⻆ |
| textAlign | string | left | 否 | ⽂本的⽔平居中⽅式 |
| fontSize | number | 14 | 否 | 字号 |
| lineHeight | number | 否 | ⽂本的⾏⾼ |
object.style.textAlign 的合法值
| 值 | 说明 |
|---|---|
| left | 居左 |
| center | 居中 |
| right | 居右 |
object.share 的结构
| 属性 | 类型 | 默认值 | 必填 | 说明 | 最低版本 |
|---|---|---|---|---|---|
| query | string | 否 | 分享的对局回放打开后跳转⼩游戏的 query | 3.7.0 | |
| timeRange | Array.[number] | 否 | 对局回放的剪辑区间,是⼀个⼆维数组,单位 ms(毫秒)。[[1000,3000], [4000, 5000]] 表示剪辑已录制对局回放的 1-3 秒和 4-5 秒最终合成为⼀个 3 秒的对局回放。对局回放剪辑后的总时⻓最多 60 秒,即 1 分钟。 | 3.19.0 | |
| bgm | string | 否 | 对局回放背景⾳乐的地址。必须是⼀个代码包⽂件路径或者 blfile:// ⽂件路径,不⽀持 http/https 开头的 url | 3.19.0 | |
| volume | number | 1 | 否 | 对局回放的音量大小,最小 0,最大 1。 | 3.19.0 |
| atempo | number | 1 | 否 | 对局回放的播放速率,只能设置以下几个值:0.3,0.5,1,1.5,2,2.5,3。其中1表示原速播放,小于1表示减速播放,大于1表示加速播放。 | 3.19.0 |
| audioMix | boolean | false | 否 | 如果原始视频文件中有音频,是否与新传入的bgm混音,默认为false,表示不混音,只保留一个音轨,值为true时表示原始音频与传入的bgm混音。 | 3.19.0 |