MediaSession:metadata 属性

可用性有限

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

MediaSession 接口的 metadata 属性包含一个 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

浏览器兼容性