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.
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