MediaMetadata: MediaMetadata() 构造函数

可用性有限

此特性不是基线特性，因为它在一些最广泛使用的浏览器中不起作用。

MediaMetadata() 构造函数创建一个新的 MediaMetadata 对象。

语法

new MediaMetadata()
new MediaMetadata(metadata)

参数

metadata 可选

metadata 参数如下：

album 可选

正在播放的媒体所属的专辑或合集的名称。默认为空字符串 ("")。

artist 可选

正在播放的媒体的艺术家、乐队或创作者的名称。默认为空字符串 ("")。

artwork 可选

一个 Array，包含表示正在播放媒体相关联的图像的对象，默认为空数组。对象结构为：

src: 用户代理从中获取图像数据的 URL。
sizes 可选: 指定多种尺寸的资源，这样用户代理就无需缩放单个图像。默认为空字符串 ("")。
type 可选: 用户代理的 MIME 类型提示，允许它忽略它不支持的类型图像。但是，用户代理仍可能在下载图像后使用 MIME 类型嗅探来确定其类型。默认为空字符串 ("")。

chapterInfo 可选

一个 ChapterInformation 对象实例的数组，表示与媒体关联的章节信息元数据。对象结构为：

artwork 可选: 一个 artwork 对象（见上文）的 Array，表示与章节关联的图像。如果省略，artwork 默认为空数组。
startTime 可选: 一个表示章节开始时间的数字（秒）。如果省略，startTime 默认为 0。
title 可选: 一个表示章节标题的字符串。如果省略，title 默认为空字符串 ("")。

title 可选

正在播放的媒体的标题。默认为空字符串 ("")。

示例

以下示例使用正确的元数据格式创建了一个新的 MediaMetadata 对象。

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

浏览器兼容性

帮助改进 MDN

了解如何贡献

此页面最后修改于 2025年6月23日，由 MDN 贡献者。

在 GitHub 上查看此页面 • 报告此内容的某个问题