ChapterInformation

可用性有限

此特性不是基線特性,因為它在一些最廣泛使用的瀏覽器中不起作用。

實驗性: 這是一項實驗性技術
在生產中使用此技術之前,請仔細檢查瀏覽器相容性表格

ChapterInformation 介面是 Media Session API 的一部分,用於表示媒體資源(即影片或音訊檔案)的單個章節的元資料。

給定媒體資源的章節資訊在其首次建立時透過 MediaMetadata() 建構函式的初始化物件中的 chapterInfo 屬性進行設定。該屬性的值是一個 ChapterInformation 物件陣列。

您可以透過現有 MediaMetadata 物件的 chapterInfo 屬性訪問其章節資訊。這將返回一個 ChapterInformation 物件陣列。

例項屬性

ChapterInformation.artwork 只讀 實驗性

返回一個 Array,其中包含表示與章節關聯的影像的物件。

ChapterInformation.startTime 只讀 實驗性

返回一個以秒為單位的數字,表示章節的開始時間。

ChapterInformation.title 只讀 實驗性

返回一個字串,表示章節的標題。

示例

以下示例程式碼來自 Video / Media Session Sample,展示了 ChapterInformation 物件的典型結構。

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

以下程式碼片段顯示瞭如何在 Media Session 程式碼中使用它(上面的物件屬性是下面引用的 playlist 物件的一部分)。

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

  // …
}

規範

規範
媒體會話
# chapterinformation

瀏覽器相容性

另見