MediaMetadata: artwork-Eigenschaft

Limited availability

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

Die artwork-Eigenschaft des MediaMetadata-Interfaces gibt ein Array von Objekten zurück oder setzt dieses. Diese Objekte repräsentieren Bilder, die mit der Wiedergabe von Medien verbunden sind.

Wert

Ein Array von Objekten, die jeweils die folgenden Felder enthalten:

src

Die URL, von der der User-Agent die Bilddaten abruft.

sizes Optional

Gibt die Ressource in mehreren Größen an, sodass der User-Agent ein einzelnes Bild nicht skalieren muss. Standardmäßig ist es der leere String ("").

type Optional

Der MIME-Typ-Hinweis für den User-Agent, der es ihm ermöglicht, Bilder von Typen zu ignorieren, die er nicht unterstützt. Der User-Agent kann jedoch nach dem Herunterladen des Bildes weiterhin MIME-Type-Sniffing verwenden, um dessen Typ zu bestimmen. Standardmäßig ist es der leere String ("").

Beispiele

Das folgende Beispiel überprüft die Browser-Kompatibilität und setzt die aktuellen Metadaten für die Media Session.

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

Browser-Kompatibilität

BCD tables only load in the browser