Navigator: mediaSession-Eigenschaft

Die schreibgeschützte mediaSession-Eigenschaft der Navigator-Schnittstelle gibt ein MediaSession-Objekt zurück, das verwendet werden kann, um mit dem Browser Metadaten und andere Informationen über den aktuellen Wiedergabestatus von Medien zu teilen, die von einem Dokument verarbeitet werden.

Diese Informationen können wiederum mit dem Gerät und/oder Betriebssystem geteilt werden, um die standardmäßige Mediensteuerungsbenutzererfahrung eines Geräts zu beschreiben und die Wiedergabe der Medien zu steuern.

Darüber hinaus bietet die MediaSession-Schnittstelle die Methode setActionHandler(), die es Ihnen ermöglicht, Ereignisse zu empfangen, wenn der Benutzer Geräte-Steuerelemente wie eingeblendete oder physische Start-, Pause-, Such- und ähnliche Steuerelemente verwendet. Eine Internetradio-App kann zum Beispiel setActionHandler() verwenden, damit die Mediensteuerelemente auf einer Tastatur oder anderswo auf dem Gerät des Benutzers zur Steuerung der Medienwiedergabe der App verwendet werden können.

Wert

Ein MediaSession-Objekt, das das aktuelle Dokument verwenden kann, um Informationen über die Medien, die es abspielt, und deren aktuellen Wiedergabestatus zu teilen. Diese Informationen können typische Metadaten wie den Titel, den Künstler und den Albumnamen des gespielten Songs sowie potenziell ein oder mehrere Bilder mit Dingen wie Albumcover, Künstlerfotos usw. enthalten.

Beispiele

In diesem Beispiel werden Metadaten an das mediaSession-Objekt übermittelt. Beachten Sie, dass der Code zunächst sicherstellt, dass die navigator.mediaSession-Eigenschaft verfügbar ist, bevor versucht wird, sie zu verwenden.

js
if ("mediaSession" in navigator) {
  navigator.mediaSession.metadata = new MediaMetadata({
    title: "Podcast Episode Title",
    artist: "Podcast Host",
    album: "Podcast Name",
    artwork: [{ src: "podcast.jpg" }],
  });
}

Spezifikationen

Specification
Media Session
# dom-navigator-mediasession

Browser-Kompatibilität

Report problems with this compatibility data on GitHub
desktopmobileserver
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
Deno
Node.js
mediaSession

Legend

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

Full support
Full support
No support
No support
See implementation notes.