# 边看边玩

# 全屏半屏切换

# 事件监听

监听窗口尺寸变化事件,在 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);
Last Updated: 2026/3/3 18:13:32