# 边看边玩

# 全屏半屏切换

# 事件监听

监听窗口尺寸变化事件,在 JSSDK 初始化后就进行调用,在边看边玩场景中,调用该方法后会显示放大缩小按钮,用户点击按钮后,触发全屏/半屏切换,根据容器大小,动态调整游戏UI,进行适配。了解更多内容请阅读芒果tv小游戏官方文档《边看边玩-全屏半屏》 (opens new window)

// 监听窗口尺寸变化事件
sdkInstance.onWindowResize(listener);

// 取消监听窗口尺寸变化事件
sdkInstance.offWindowResize(listener);

# 参数说明

监听函数 listener 的返回值说明如下表所示:

属性 类型 说明
code number 响应状态码,为 0 时表示支持窗口尺寸变化事件,其他非 0 状态码均表示不支持窗口尺寸变化事件
data object / null 支持返回窗口尺寸信息,不支持返回 null
    data.size object 窗口尺寸信息
        data.size.windowWidth number 窗口宽度
        data.size.windowHeight number 窗口高度
message string 描述信息

# 示例代码

注:示例代码中的参数或选项均为演示数据,仅供参考,谢谢!

// 监听函数
const listener = function(response) {
  // response = { code: 0, data: {}, message: "" }
  // response.data.size = { windowHeight: 2590, windowWidth: 1260 }
  // code: 0 表示支持
  if (response.code == 0) {
    console.log("size", response.data);
  } 
}

// 监听窗口尺寸变化事件
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 的返回值说明如下表所示:

属性 类型 说明
code number 响应状态码,为 0 时表示支持调节音量事件,其他非 0 状态码均表示不支持调节音量事件
data object / null 支持返回音量值,不支持返回 null
    data.volume number 音量值,范围 0 ~ 1
message 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(response) {
  // response = { code: 0, data: {}, message: "" }
  // response.data = { volume: 0.55 };
  // code: 0 表示支持
  if (response.code == 0) {
    console.log("volume", response.data);
  } 
}

// 监听用户调节音量事件
sdkInstance.onVolumeChange(listener);

// 取消监听用户调节音量事件
sdkInstance.offVolumeChange(listener);
Last Updated: 2026/3/27 18:08:19