大网数据广告活动
Web 标准与前端开发

MediaSession:playbackState 属性

· 52CE 我爱测

MediaSession 接口的 **`playbackState`** 属性用于表示当前媒体会话是播放还是暂停状态。

Media Session API

MediaSession 接口的 playbackState 属性用于表示当前媒体会话是播放还是暂停状态。

值

一个表示当前媒体会话的播放状态的字符串。值可以是以下之一:

  • none
    • : 浏览上下文当前无法得知播放状态,或者该状态暂不可用。
  • paused
    • : 浏览器的媒体会话当前已暂停。可以恢复播放。
  • playing
    • : 浏览器的媒体会话当前正在播放媒体,可以暂停。

示例

以下示例设置了播放和暂停两个函数,然后将它们作为相应的操作处理器配合使用。每个函数都利用 playbackState 属性来指示音频是否正在播放或已暂停。

const actionHandlers = [
  // 播放
  [
    "play",
    async () => {
      // 播放音频
      await audioEl.play();
      // 设置播放状态
      navigator.mediaSession.playbackState = "playing";
      // 更新状态元素
      updateStatus(allMeta[index], "操作:播放 | 播放中...");
    },
  ],
  [
    "pause",
    () => {
      // 暂停音频
      audioEl.pause();
      // 设置播放状态
      navigator.mediaSession.playbackState = "paused";
      // 更新状态元素
      updateStatus(allMeta[index], "操作:暂停 | 已暂停...");
    },
  ],
];

for (const [action, handler] of actionHandlers) {
  try {
    navigator.mediaSession.setActionHandler(action, handler);
  } catch (error) {
    console.log(`目前仍未支持媒体会话操作“${action}”`);
  }
}

规范

浏览器兼容性

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。