MediaMetadata

可用性有限

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

MediaMetadata 介面屬於 Media Session API,允許網頁提供豐富的媒體元資料,以便在平臺 UI 中顯示。

建構函式

MediaMetadata()

建立一個新的 MediaMetaData 物件。

例項屬性

MediaMetadata.album

返回或設定包含要播放媒體的專輯或合集名稱。

MediaMetadata.artist

返回或設定要播放媒體的藝術家、團體、創作者等的名稱。

MediaMetadata.artwork

返回或設定與正在播放的媒體相關聯的影像陣列。

MediaMetadata.chapterInfo 只讀 實驗性

返回與正在播放的媒體相關聯的章節資訊元資料陣列,由 ChapterInformation 物件例項表示。

MediaMetadata.title

返回或設定要播放媒體的標題。

示例

以下示例檢查瀏覽器相容性並設定媒體會話的當前元資料。

js
if ("mediaSession" in navigator) {
  navigator.mediaSession.metadata = new MediaMetadata({
    title: "Unforgettable",
    artist: "Nat King Cole",
    album: "The Ultimate Collection (Remastered)",
    artwork: [
      {
        src: "https://dummyimage.com/96x96",
        sizes: "96x96",
        type: "image/png",
      },
      {
        src: "https://dummyimage.com/128x128",
        sizes: "128x128",
        type: "image/png",
      },
      {
        src: "https://dummyimage.com/192x192",
        sizes: "192x192",
        type: "image/png",
      },
      {
        src: "https://dummyimage.com/256x256",
        sizes: "256x256",
        type: "image/png",
      },
      {
        src: "https://dummyimage.com/384x384",
        sizes: "384x384",
        type: "image/png",
      },
      {
        src: "https://dummyimage.com/512x512",
        sizes: "512x512",
        type: "image/png",
      },
    ],
  });
}

規範

規範
媒體會話
# the-mediametadata-interface

瀏覽器相容性