ChapterInformation

Die ChapterInformation-Schnittstelle der Media Session API repräsentiert die Metadaten für ein einzelnes Kapitel einer Medienressource (d.h. einer Video- oder Audiodatei).

Die Kapitelinformation für eine gegebene Medienressource wird festgelegt, wenn sie zuerst erstellt wird, über die chapterInfo-Eigenschaft des Initialisierungsobjekts des MediaMetadata()-Konstruktors. Die Eigenschaft nimmt ein Array von ChapterInformation-Objekten als Wert.

Sie können auf die Kapitelinformationen eines bestehenden MediaMetadata-Objekts über seine chapterInfo-Eigenschaft zugreifen. Dies gibt ein Array von ChapterInformation-Objekten zurück.

Instanz-Eigenschaften

ChapterInformation.artwork Schreibgeschützt

Gibt ein Array von Objekten zurück, die Bilder darstellen, die mit dem Kapitel verbunden sind.

ChapterInformation.startTime Schreibgeschützt

Gibt eine Zahl in Sekunden zurück, die die Startzeit des Kapitels darstellt.

ChapterInformation.title Schreibgeschützt

Gibt einen String zurück, der den Titel des Kapitels darstellt.

Beispiele

Das folgende Beispiel zeigt eine typische Struktur des ChapterInformation-Objekts aus Video / Media Session Sample:

const BASE_URL = "https://storage.googleapis.com/media-session/";
const metadata = {
 // ...
 chapterInfo: [
 {
 title: "Chapter 1",
 startTime: 0,
 artwork: [
 {
 src: `${BASE_URL}sintel/chapter1-128.png`,
 sizes: "128x128",
 type: "image/png",
 },
 {
 src: `${BASE_URL}sintel/chapter1-512.png`,
 sizes: "512x512",
 type: "image/png",
 },
 ],
 },
 {
 title: "Chapter 2",
 startTime: 37,
 artwork: [
 {
 src: `${BASE_URL}sintel/chapter2-128.png`,
 sizes: "128x128",
 type: "image/png",
 },
 {
 src: `${BASE_URL}sintel/chapter2-512.png`,
 sizes: "512x512",
 type: "image/png",
 },
 ],
 },
 ],
};

Der folgende Ausschnitt zeigt, wie es im Media Session Code verwendet werden kann (die oben stehende Objekt-Eigenschaft ist Teil des playlist-Objekts, das unten referenziert wird):

function updateMetadata() {
 const track = playlist[index];
 log(`Playing ${track.title} track...`);
 navigator.mediaSession.metadata = new MediaMetadata({
 title: track.title,
 artist: track.artist,
 artwork: track.artwork,
 chapterInfo: track.chapterInfo,
 });
 // ...
}

Spezifikationen

Browser-Kompatibilität

Siehe auch

• MediaMetadata