MediaSession: playbackState-Eigenschaft

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Die playbackState-Eigenschaft der MediaSession-Schnittstelle gibt an, ob die aktuelle Mediensitzung abgespielt oder pausiert wird.

Wert

Ein String, der den aktuellen Wiedergabestatus der Mediensitzung angibt. Der Wert kann einer der folgenden sein:

none

Der Browsing-Kontext kennt den aktuellen Wiedergabestatus derzeit nicht oder der Wiedergabestatus ist zu diesem Zeitpunkt nicht verfügbar.

paused

Die Medien-Sitzung des Browsers ist derzeit pausiert. Die Wiedergabe kann fortgesetzt werden.

playing

Die Medien-Sitzung des Browsers spielt derzeit Medien ab, die pausiert werden können.

Beispiel

Im folgenden Beispiel werden zwei Funktionen zum Abspielen und Pausieren eingerichtet und dann als Rückruf mit den entsprechenden Aktionshandlern verwendet. Jede Funktion nutzt die playbackState-Eigenschaft, um anzuzeigen, ob das Audio abgespielt oder pausiert wird.

js
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.`);
  }
}

Spezifikationen

Specification
Media Session
# dom-mediasession-playbackstate

Browser-Kompatibilität

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
playbackState

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
Partial support
Partial support
No support
No support