MediaMetadata

可用性有限

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

MediaMetadata 接口属于 Media Session 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

浏览器兼容性