MediaMetadata: MediaMetadata() Konstruktor
Der MediaMetadata()
Konstruktor erstellt ein neues
MediaMetadata
Objekt.
Syntax
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
vonartwork
Objekten (siehe oben), die Bilder repräsentieren, die mit dem Kapitel assoziiert sind. Wenn weggelassen, istartwork
standardmäßig ein leeres Array. startTime
Optional-
Eine Zahl, die die Startzeit des Kapitels in Sekunden darstellt. Wenn weggelassen, ist
startTime
standardmäßig0
. 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.
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