MediaSession:metadata 屬性

可用性有限

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

MediaSession 介面的 metadata 屬性包含一個 MediaMetadata 物件,該物件提供有關當前正在播放的媒體的描述性資訊,如果尚未設定元資料,則為 null。瀏覽器將此元資料提供給裝置,以便在裝置可能提供的任何標準媒體控制使用者介面中顯示。

一個包含有關當前正在播放的媒體資訊的 MediaMetadata 例項。

示例

以下示例檢查相容性並建立一個包含相關元資料的新媒體會話。

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

規範

規範
媒體會話
# dom-mediasession-metadata

瀏覽器相容性