MediaSession
Experimental: 这是一个实验中的功能
此功能某些浏览器尚在开发中,请参考浏览器兼容性表格以得到在不同浏览器中适合使用的前缀。由于该功能对应的标准文档可能被重新修订,所以在未来版本的浏览器中该功能的语法和行为可能随之改变。
Media Session API (en-US) 的 MediaSession
接口允许页面为标准媒体交互提供自定义行为。
属性
MediaSession.metadata
(en-US)-
指向一个
MediaMetadata
(en-US) 的实例,其包含富媒体的元数据。该数据将用于平台显示。 MediaSession.playbackState
(en-US)-
展示当前 mediasession 是否处于播放状态。有效值为
"none"
,"paused"
,"playing"
.
方法
MediaSession.setActionHandler()
-
设置一个监听 mediasession 动作 (如 play 或者 pause) 的事件句柄。浏览方法页以获取所有动作的列表。
例子
下面的例子创建了一个新的 media session,并且给其绑定了一些动作句柄:
if ('mediaSession' in navigator){
navigator.mediaSession.metadata = new MediaMetadata({
title: "Podcast Episode Title",
artist: "Podcast Host",
album: "Podcast Name",
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";
}
规范
Specification |
---|
Media Session Standard # the-mediasession-interface |
浏览器兼容性
BCD tables only load in the browser