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 Kapitelinformationen für eine gegebene Medienressource werden 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. Diese 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 assoziiert 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

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

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 Ausschnitt zeigt, wie er im Media Session-Code verwendet werden kann (die oben genannte Objekteigenschaft ist Teil des unten referenzierten playlist-Objekts):

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