MediaMetadata: artwork 屬性

可用性有限

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

artwork 屬性是 MediaMetadata 介面的一部分，它返回或設定一個物件陣列，代表與正在播放的媒體關聯的影像。

值

一個物件 Array，每個物件包含以下欄位：

src: 使用者代理從中獲取影像資料的 URL。
sizes 可選: 指定多種大小的資源，這樣使用者代理就不必對單個影像進行縮放。它預設為空字串 ("")。
type 可選: 為使用者代理提供的 MIME 型別提示，允許使用者代理忽略其不支援的影像型別。然而，使用者代理在下載影像後仍可能使用 MIME 型別嗅探來確定其型別。它預設為空字串 ("")。

示例

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

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-mediametadata-artwork

瀏覽器相容性

幫助改進 MDN

瞭解如何貢獻

此頁面最後修改於 2024年8月7日，由 MDN 貢獻者更改。

在 GitHub 上檢視此頁面 • 報告此內容的問題