Signatur
Beschreibung
Die Eigenschaft album des MediaMetadata-Interfaces enthält den Namen des Albums, der Playlist, der Podcast-Staffel oder einer anderen Sammlung, zu der das aktuell abgespielte Medium gehört. Sie ist Teil der Media Session API und wird vom Browser an das Betriebssystem weitergereicht.
Dort erscheint der Wert in den System-Mediensteuerungen, etwa auf dem Sperrbildschirm von Android, im Benachrichtigungsbereich, in der macOS-Menüleiste („Aktuelle Wiedergabe“), in der Windows-Medienübersicht oder auf verbundenen Geräten wie Smartwatches und Autoradios. Zusammen mit title, artist und artwork sorgt die Angabe dafür, dass Nutzer außerhalb des Browser-Tabs erkennen, was gerade läuft.
Den Wert setzt man entweder über das Initialisierungsobjekt im Konstruktor new MediaMetadata({ album: "…" }) oder nachträglich durch direkte Zuweisung. Wirksam wird er erst, wenn das MediaMetadata-Objekt an navigator.mediaSession.metadata übergeben wurde. Ändert man danach album am selben Objekt, aktualisiert der Browser in der Regel auch die Systemanzeige.
Parameter
| Name | Typ | Default | Beschreibung |
|---|---|---|---|
| $value | string | "" | Beim Setzen: der neue Album- bzw. Sammlungsname. Nicht-String-Werte werden in einen String umgewandelt (z. B. null → "null"). |
Rückgabewert
"".Beispiele
Album beim Erzeugen der Metadaten angeben
if ('mediaSession' in navigator) {
const metadata = new MediaMetadata({
title: 'Clair de Lune',
artist: 'Claude Debussy',
album: 'Suite bergamasque',
artwork: [
{ src: '/covers/bergamasque-512.png', sizes: '512x512', type: 'image/png' }
]
});
navigator.mediaSession.metadata = metadata;
console.log(navigator.mediaSession.metadata.album);
}Album beim Titelwechsel in einer Playlist aktualisieren
const playlist = [
{ src: '/audio/ep01.mp3', title: 'Folge 1: Einstieg', album: 'Webdev-Podcast – Staffel 1' },
{ src: '/audio/ep12.mp3', title: 'Folge 12: Neustart', album: 'Webdev-Podcast – Staffel 2' }
];
const audio = document.querySelector('audio');
const metadata = new MediaMetadata({ artist: 'programmierung.net' });
navigator.mediaSession.metadata = metadata;
const playTrack = async (index) => {
const track = playlist[index];
audio.src = track.src;
// Bestehendes Objekt direkt anpassen
metadata.title = track.title;
metadata.album = track.album;
await audio.play();
console.log(`Läuft: ${metadata.title} (${metadata.album})`);
};
document.querySelector('#next').addEventListener('click', () => playTrack(1));Standardwert und Typumwandlung
const meta = new MediaMetadata({ title: 'Einzeltitel' });
console.log(JSON.stringify(meta.album));
meta.album = 2024;
console.log(typeof meta.album, meta.album);// Wichtig · Fallstricke
- Nur zusammen mit
navigator.mediaSession.metadatasichtbar: Ein einfach erzeugtesMediaMetadata-Objekt hat keinerlei Wirkung, solange es nicht zugewiesen wurde. - Anzeige nicht garantiert: Ob und wo das Album angezeigt wird, entscheiden Betriebssystem und Browser. Manche Oberflächen zeigen nur Titel und Interpret. Deshalb keine wichtigen Informationen ausschließlich in
albumunterbringen. - Wiedergabe erforderlich: Die meisten Browser zeigen die Systemsteuerung erst, wenn tatsächlich ein Medium hörbar abgespielt wird. Bei Chrome muss es zudem oft länger als ein paar Sekunden laufen.
- Typumwandlung:
nullundundefinedwerden zu"null"bzw."undefined". Zum Leeren besser""zuweisen. - Kompatibilität: Wird von allen aktuellen Browsern unterstützt (Firefox ab 82, Safari ab 15). Vorher mit
'mediaSession' in navigatorprüfen. Nur in sicheren Kontexten (HTTPS) zuverlässig verfügbar.