Информация о главе

Интерфейс ChapterInformation из API сессии медиа представляет метаданные для отдельной главы медиа-ресурса (например, видео или аудиофайла).

Информация о главе для данного медиа-ресурса задаётся при её первом создании через свойство chapterInfo объекта инициализации конструктора MediaMetadata(). Свойство принимает в качестве значения массив объектов ChapterInformation.

Вы можете получить доступ к информации о главе для существующего объекта MediaMetadata через его свойство chapterInfo. Это возвращает массив объектов ChapterInformation.

ChapterInformation.artwork Только для чтения Экспериментально

Возвращает массив Array объектов, представляющих изображения, связанные с главой.

ChapterInformation.startTime Только для чтения Экспериментально

Возвращает число, в секундах, представляющее начальное время главы.

ChapterInformation.title Только для чтения Экспериментально

Возвращает строку, представляющую заголовок главы.

Пример кода ниже из Примера видео/сессии медиа показывает типичную структуру объекта ChapterInformation:

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",
      },
    ],
  },
];

Следующий фрагмент кода демонстрирует, как его можно использовать внутри кода сессии медиа (свойство объекта выше является частью объекта playlist, на который ссылаются ниже):

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,
  });

  // ...
}

• MediaMetadata