MediaSession:metadata 属性

可用性有限

此功能不是基线功能,因为它在一些使用最广泛的浏览器中无法正常工作。

metadataMediaSession 接口的一个属性,它包含一个 MediaMetadata 对象,该对象提供了有关当前正在播放的媒体的描述性信息,如果未设置元数据,则为 null。浏览器将此元数据提供给设备,以便在设备可能提供的任何标准媒体控制用户界面中进行呈现。

一个 MediaMetadata 实例,其中包含有关当前正在播放的媒体的信息。

示例

以下示例检查兼容性并使用相关元数据创建一个新的媒体会话

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

规范

规范
媒体会话
# dom-mediasession-metadata

浏览器兼容性

BCD 表格仅在启用了 JavaScript 的浏览器中加载。