ChapterInformation

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

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

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 Experimentell: Gibt ein Array von Objekten zurück, die Bilder darstellen, die mit dem Kapitel verbunden sind.
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 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

Specification
Media Session # chapterinformation

Browser-Kompatibilität

Siehe auch

MediaMetadata