ChapterInformation

Experimentell: Dies ist eine experimentelle Technologie
Überprüfen Sie die Browser-Kompatibilitätstabelle sorgfältig, bevor Sie diese produktiv verwenden.

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 Nur lesbar Experimentell: Gibt ein Array von Objekten zurück, die mit dem Kapitel verknüpfte Bilder repräsentieren.
ChapterInformation.startTime Nur lesbar Experimentell: Gibt eine Zahl in Sekunden zurück, die die Startzeit des Kapitels darstellt.
ChapterInformation.title Nur lesbar 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:

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):

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

MediaMetadata