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

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
artwork

Legend

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

Full support
Full support
No support
No support