MediaSession - 允许网页为标准媒体回放交互提供自定义行为

MediaSession 是 Media Session API 的接口，允许网页为标准媒体回放交互提供自定义行为。

属性

MediaSession.metadata

返回包含富媒体元数据的 MediaMetadata 实例，以便在平台 UI 中显示。

MediaSession.playbackState

指示当前媒体会话是否正在播放。有效值为 "none", "paused" 或 "playing"。

方法

MediaSession.setActionHandler()

为媒体会话操作设置事件处理程序，例如播放或暂停。有关完整列表，请参阅方法页面。

实例

以下实例创建一个新的媒体会话并为其分配操作处理程序：

if ('mediaSession' in navigator){
  navigator.mediaSession.metadata = new MediaMetadata({
    title: "播客剧集标题",
    artist: "播客主持人",
    album: "播客名称",
    artwork: [{src: "podcast.jpg"}]
  });
  navigator.mediaSession.setActionHandler('play', function() {});
  navigator.mediaSession.setActionHandler('pause', function() {});
  navigator.mediaSession.setActionHandler('seekbackward', function() {});
  navigator.mediaSession.setActionHandler('seekforward', function() {});
  navigator.mediaSession.setActionHandler('previoustrack', function() {});
  navigator.mediaSession.setActionHandler('nexttrack', function() {});
}

以下示例设置暂停和播放的事件处理程序：

var audio = document.querySelector("#player");
audio.src = "song.mp3";

navigator.mediaSession.setActionHandler('play', play);
navigator.mediaSession.setActionHandler('pause', pause);

function play() {
   audio.play();
   navigator.mediaSession.playbackState = "playing";
}

function pause() {
   audio.pause();
   navigator.mediaSession.playbackState = "paused";
}

规范

规范	状态	备注
Media Session Standard MediaSession 的定义	草稿	初始定义。

桌面浏览器兼容性

移动浏览器兼容性