Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

MediaMetadata: MediaMetadata() Konstruktor

Limited availability

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

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 Erstellers des abzuspielenden Mediums. Der Standardwert ist der leere String ("").

artwork Optional

Ein Array von Objekten, die Bilder repräsentieren, die mit dem abspielenden Medium verbunden sind. Der Standardwert ist ein leeres Array. Die Objektstruktur ist:

src

Die URL, von der der Benutzeragent die Bilddaten abruft.

sizes Optional

Gibt die Ressource in mehreren Größen an, sodass der Benutzeragent kein 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 dessen Typ zu bestimmen. Der Standardwert ist der leere String ("").

chapterInfo Optional

Ein Array von ChapterInformation Objektinstanzen, die die Kapitelinformationsmetadaten repräsentieren, die mit dem Medium verbunden sind. Die Objektstruktur ist:

artwork Optional

Ein Array von artwork Objekten (siehe oben), die Bilder repräsentieren, die mit dem Kapitel verbunden sind. Wenn weggelassen, ist der Standardwert von artwork ein leeres Array.

startTime Optional

Eine Zahl, die die Startzeit des Kapitels in Sekunden darstellt. Wenn weggelassen, ist der Standardwert von startTime 0.

title Optional

Ein String, der den Titel des Kapitels darstellt. Wenn weggelassen, ist der Standardwert von title 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 mit dem korrekten Format der Metadaten.

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