# 边看边玩
# 全屏半屏切换
# 事件监听
监听窗口尺寸变化事件,在 JSSDK 初始化后就进行调用,在边看边玩场景中,调用该方法后会显示放大缩小按钮,用户点击按钮后,触发全屏/半屏切换,根据容器大小,动态调整游戏UI,进行适配。了解更多内容请阅读芒果tv小游戏官方文档《边看边玩-全屏半屏》 (opens new window)
// 监听窗口尺寸变化事件
sdkInstance.onWindowResize(listener);
// 取消监听窗口尺寸变化事件
sdkInstance.offWindowResize(listener);
# 参数说明
监听函数 listener 的返回值说明如下表所示:
| 属性 | 类型 | 说明 |
|---|---|---|
| size | object | 窗口尺寸信息,注意:若此属性不存在表示不支持该监听事件 |
| size.windowWidth | number | 窗口宽度 |
| size.windowHeight | number | 窗口高度 |
| errCode | number | 错误码 |
| errMsg | string | 错误信息描述 |
# 示例代码
注:示例代码中的参数或选项均为演示数据,仅供参考,谢谢!
// 监听函数
const listener = function(result) {
// result = { size: {}, errCode: -1, errMsg: "暂不支持窗口尺寸变化事件" };
// result.size = { windowHeight: 2590, windowWidth: 1260 };
// 若 size 属性不存在表示不支持
if (result.hasOwnProperty("size")) {
console.log("size", result.size);
}
}
// 监听窗口尺寸变化事件
sdkInstance.onWindowResize(listener);
// 取消监听窗口尺寸变化事件
sdkInstance.offWindowResize(listener);
# 声音适配
在边看边玩场景中,控制游戏内声音的播放、暂停或者调整音量。了解更多内容请阅读芒果tv小游戏官方文档《边看边玩-声音适配》 (opens new window)
# 音量按钮控制
在边看边玩应用场景中,显示音量控制按钮。
sdkInstance.showVolume(options);
参数说明如下表所示:
| 选项 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
| enabled | boolean | 否 | false | true 显示音量控制按钮,false 隐藏音量控制钮 |
| defaultVolume | number | 否 | 0 | 游戏初始音量,范围 0 ~ 1,默认值 0 |
| success | function | 否 | -- | 接口调用成功的回调函数 |
| fail | function | 否 | -- | 接口调用失败的回调函数 |
| complete | function | 否 | -- | 接口调用完成的回调函数,成功或失败均会调用 |
# 事件监听
监听和取消监听用户调节音量的事件。
// 监听用户调节音量事件
sdkInstance.onVolumeChange(listener);
// 取消监听用户调节音量事件
sdkInstance.offVolumeChange(listener);
监听函数 listener 的返回值说明如下表所示:
| 属性 | 类型 | 说明 |
|---|---|---|
| volume | number | 音量值,范围 0 ~ 1,注意:若此属性不存在表示不支持该监听事件 |
| errCode | number | 错误码 |
| errMsg | string | 错误信息描述 |
# 示例代码
注:示例代码中的参数或选项均为演示数据,仅供参考,谢谢!
// 显示音量按钮
sdkInstance.showVolume({
enabled: true, // true 显示; false 隐藏
defaultVolume: 0.55, // 0-1,默认 0
success: function(response) {
// 接口调用成功
console.log("success", response);
},
fail: function(error) {
// 接口调用失败,error.code === -1 表示该方法不支持,其他调用失败
console.log("error", error);
},
complete: function(result) {
//
console.log("result", result);
}
});
// 监听音量调节
const listener = function(result) {
// result = { volume: 0.55, errCode: -1, errMsg: "暂不支持调节音量事件" };
// 若 volume 属性不存在表示不支持
if (result.hasOwnProperty("volume")) {
console.log("volume", result.volume);
}
}
// 监听用户调节音量事件
sdkInstance.onVolumeChange(listener);
// 取消监听用户调节音量事件
sdkInstance.offVolumeChange(listener);