此页面由社区从英文翻译而来。了解更多并加入 MDN Web Docs 社区。

View in English Always switch to English

MediaMetadata

有限可用

此特性不属于基线,因为它尚未在主流浏览器中得到支持。

Want more browser support for this feature? Tell us why.

媒体会话 API 的 MediaMetadata 接口允许网页提供丰富的媒体元数据,以便在平台用户界面中显示。

构造函数

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: "纳特·金·科尔",
    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",
      },
    ],
  });
}

规范

规范
Media Session
# the-mediametadata-interface

浏览器兼容性