MediaMetadata

有限可用性

此功能并非基线功能,因为它在一些最常用的浏览器中无法正常工作。

MediaMetadata 接口是 媒体会话 API 的一部分,它允许网页提供丰富的媒体元数据,以便在平台 UI 中显示。

构造函数

MediaMetadata()

创建一个新的 MediaMetaData 对象。

实例属性

MediaMetadata.album

返回或设置要播放的媒体所在的专辑或合辑的名称。

MediaMetadata.artist

返回或设置要播放的媒体的艺术家、乐队、创作者等的名称。

MediaMetadata.artwork

返回或设置与正在播放的媒体关联的图像数组。

MediaMetadata.chapterInfo 只读 实验性

返回一个与正在播放的媒体关联的章节信息元数据数组,由 ChapterInformation 对象实例表示。

MediaMetadata.title

返回或设置要播放的媒体的标题。

示例

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

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",
      },
    ],
  });
}

规范

规范
媒体会话
# the-mediametadata-interface

浏览器兼容性

BCD 表格仅在浏览器中加载