MediaMetadata:MediaMetadata() 构造函数

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

语法

js
new MediaMetadata()
new MediaMetadata(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 对象。

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

浏览器兼容性

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