ChapterInformation

Experimentell: Dies ist eine experimentelle Technologie
Überprüfen Sie die Browser-Kompatibilitätstabelle sorgfältig vor der Verwendung auf produktiven Webseiten.

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

Die Kapitelinformationen für eine gegebene Medienressource werden beim Erstellen über die chapterInfo-Eigenschaft des Initialisierungsobjekts des MediaMetadata()-Konstruktors gesetzt. Die Eigenschaft nimmt ein Array von ChapterInformation-Objekten als Wert an.

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

Instanzeigenschaften

ChapterInformation.artwork Schreibgeschützt Experimentell

Gibt ein Array von Objekten zurück, die mit dem Kapitel verknüpfte Bilder repräsentieren.

ChapterInformation.startTime Schreibgeschützt Experimentell

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

ChapterInformation.title Schreibgeschützt Experimentell

Gibt einen String zurück, der den Titel des Kapitels repräsentiert.

Beispiele

Der untenstehende Beispielcode aus dem Video / Media Session Sample zeigt eine typische Struktur für das ChapterInformation-Objekt:

js
const BASE_URL = "https://storage.googleapis.com/media-session/";

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 Codeausschnitt zeigt, wie es innerhalb des Media Session-Codes verwendet werden kann (die oben angegebenen Objekt-Eigenschaften sind Teil des weiter unten referenzierten playlist-Objekts):

js
function updateMetadata() {
  let 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

Specification
Media Session
# chapterinformation

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch