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

BCD tables only load in the browser