大网数据广告活动
Web 标准与前端开发

MediaMetadata:MediaMetadata() 构造函数

· 52CE 我爱测

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

Media Session API

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

语法

new MediaMetadata()
new MediaMetadata(metadata)

参数

  • metadata
    • : metadata 参数如下:
      • album
        • : 包含待播放媒体的专辑或合集的名称。默认为空字符串("")。
      • artist
        • : 包含待播放媒体的艺术家、乐队、创作者等的名称。默认为空字符串("")。
      • artwork
        • : 表示与正在播放的媒体相关联的图像的对象Array,默认值为空数组。对象结构如下:
          • src
            • : 用户代理用于获取图像数据的 URL。
          • sizes
            • : 指定多种尺寸的资源,以便用户代理无需对单张图片进行缩放。默认为空字符串("")。
          • type
            • : 允许用户代理忽略其不支持类型图像的 MIME type提示。不过,用户代理在下载图像后仍可能通过 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: "纳特·金·科尔",
    album: "终极合集(重制版)",
    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",
      },
    ],
  });
}

规范

浏览器兼容性

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。