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.

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

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
ChapterInformation
Experimental
artwork
Experimental
startTime
Experimental
title
Experimental

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
No support
No support
Experimental. Expect behavior to change in the future.

Siehe auch