MediaSession：playbackState 属性

可用性有限

此特性不是基线特性，因为它在一些最广泛使用的浏览器中不起作用。

playbackState 属性是 MediaSession 接口的一部分，它指示当前媒体会话是正在播放还是已暂停。

值

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

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

示例

以下示例设置了两个用于播放和暂停的函数，然后将它们用作相关操作处理程序的 callbacks。每个函数都利用 playbackState 属性来指示音频是正在播放还是已暂停。

const actionHandlers = [
  // play
  [
    "play",
    async () => {
      // play our audio
      await audioEl.play();
      // set playback state
      navigator.mediaSession.playbackState = "playing";
      // update our status element
      updateStatus(allMeta[index], "Action: play  |  Track is playing…");
    },
  ],
  [
    "pause",
    () => {
      // pause out audio
      audioEl.pause();
      // set playback state
      navigator.mediaSession.playbackState = "paused";
      // update our status element
      updateStatus(allMeta[index], "Action: pause  |  Track has been paused…");
    },
  ],
];

for (const [action, handler] of actionHandlers) {
  try {
    navigator.mediaSession.setActionHandler(action, handler);
  } catch (error) {
    console.log(`The media session action "${action}" is not supported yet.`);
  }
}

规范

规范
媒体会话 # dom-mediasession-playbackstate

浏览器兼容性

帮助改进 MDN

了解如何贡献

此页面由 MDN 贡献者在 2023 年 4 月 7 日最后修改。

在 GitHub 上查看此页面 • 报告此内容的问题