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

View in English Always switch to English

MediaMetadata

有限可用

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

Want more support for this feature? Tell us why.

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

构造函数

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

浏览器兼容性