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 上查看此页面 • 报告此内容的问题