MediaMetadata:artwork 属性

artwork 属性是 MediaMetadata 接口的一部分,用于返回或设置一个对象数组,这些对象表示与正在播放的媒体关联的图像。

一个 Array 对象,每个对象包含以下字段

src

用户代理从中获取图像数据的 URL。

sizes 可选

以多种尺寸指定资源,以便用户代理无需缩放单个图像。默认为空字符串 ("")。

type 可选

用户代理的 MIME 类型 提示,允许它忽略其不支持的类型的图像。但是,用户代理在下载图像后可能仍会使用 MIME 类型嗅探来确定其类型。默认为空字符串 ("")。

示例

以下示例检查浏览器兼容性并设置媒体会话的当前元数据。

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

浏览器兼容性

BCD 表格仅在启用 JavaScript 的浏览器中加载。