MediaMetadata: MediaMetadata() Konstruktor

Der MediaMetadata() Konstruktor erstellt ein neues MediaMetadata Objekt.

Syntax

js
new MediaMetadata()
new MediaMetadata(metadata)

Parameter

metadata Optional

Die Metadatenparameter sind wie folgt:

album Optional

Der Name des Albums oder der Sammlung, die das abzuspielende Medium enthält. Der Standardwert ist der leere String ("").

artist Optional

Der Name des Künstlers, der Gruppe oder des Schöpfers des abzuspielenden Mediums. Der Standardwert ist der leere String ("").

artwork Optional

Ein Array von Objekten, die Bilder repräsentieren, die mit dem abspielenden Medium assoziiert sind und standardmäßig ein leeres Array sind. Die Struktur des Objekts ist:

src

Die URL, von der der Benutzeragent die Bilddaten abruft.

sizes Optional

Gibt die Ressource in mehreren Größen an, sodass der Benutzeragent nicht ein einzelnes Bild skalieren muss. Der Standardwert ist der leere String ("").

type Optional

Der MIME-Typ Hinweis für den Benutzeragenten, der es ihm ermöglicht, Bilder von Typen zu ignorieren, die er nicht unterstützt. Der Benutzeragent kann jedoch nach dem Herunterladen des Bildes immer noch MIME-Typ-Sniffing verwenden, um seinen Typ zu bestimmen. Der Standardwert ist der leere String ("").

chapterInfo Optional

Ein Array von ChapterInformation Objektinstanzen, die die Kapitelinformations-Metadaten darstellen, die mit dem Medium verknüpft sind. Die Struktur des Objekts ist:

artwork Optional

Ein Array von artwork Objekten (siehe oben), die Bilder repräsentieren, die mit dem Kapitel assoziiert sind. Wenn weggelassen, ist artwork standardmäßig ein leeres Array.

startTime Optional

Eine Zahl, die die Startzeit des Kapitels in Sekunden darstellt. Wenn weggelassen, ist startTime standardmäßig 0.

title Optional

Ein String, der den Titel des Kapitels darstellt. Wenn weggelassen, ist title standardmäßig der leere String ("").

title Optional

Der Titel des abzuspielenden Mediums. Der Standardwert ist der leere String ("").

Beispiel

Das folgende Beispiel erstellt ein neues MediaMetadata Objekt unter Verwendung des korrekten Metadatenformats.

js
if ("mediaSession" in navigator) {
  navigator.mediaSession.metadata = new MediaMetadata({
    title: "Unforgettable",
    artist: "Nat King Cole",
    album: "The Ultimate Collection (Remastered)",
    artwork: [
      {
        src: "https://dummyimage.com/96x96",
        sizes: "96x96",
        type: "image/png",
      },
      {
        src: "https://dummyimage.com/128x128",
        sizes: "128x128",
        type: "image/png",
      },
      {
        src: "https://dummyimage.com/192x192",
        sizes: "192x192",
        type: "image/png",
      },
      {
        src: "https://dummyimage.com/256x256",
        sizes: "256x256",
        type: "image/png",
      },
      {
        src: "https://dummyimage.com/384x384",
        sizes: "384x384",
        type: "image/png",
      },
      {
        src: "https://dummyimage.com/512x512",
        sizes: "512x512",
        type: "image/png",
      },
    ],
  });
}

Spezifikationen

Specification
Media Session
# dom-mediametadata-mediametadata

Browser-Kompatibilität

BCD tables only load in the browser