导航器:mediaSession 属性

mediaSessionNavigator 接口的只读属性,它返回一个 MediaSession 对象,该对象可用于与浏览器共享有关由文档处理的当前媒体的播放状态的元数据和其他信息。

然后,这些信息可能会与设备和/或操作系统共享,以便设备的标准媒体控制用户体验来描述和控制媒体的播放。

此外,MediaSession 接口提供了 setActionHandler() 方法,该方法允许您在用户使用设备控件(如屏幕或物理播放、暂停、搜索和其他类似控件)时接收事件。例如,互联网广播应用程序可以使用 setActionHandler() 来允许键盘或用户设备上的其他位置的媒体控件用于控制应用程序的媒体播放。

价值

一个 MediaSession 对象,当前文档可以使用它来共享有关其正在播放的媒体及其当前播放状态的信息。这些信息可以包括典型的元数据,如正在播放歌曲的标题、艺术家和专辑名称,以及可能包含专辑封面、艺术家照片等的图像。

示例

在此示例中,元数据被提交到 mediaSession 对象。请注意,该代码首先确保 navigator.mediaSession 属性可用,然后才尝试使用它。

js
if ("mediaSession" in navigator) {
  navigator.mediaSession.metadata = new MediaMetadata({
    title: "Podcast Episode Title",
    artist: "Podcast Host",
    album: "Podcast Name",
    artwork: [{ src: "podcast.jpg" }],
  });
}

规范

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

浏览器兼容性

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