语法
js
new MediaMetadata()
new MediaMetadata(metadata)
参数
metadata可选-
metadata 参数如下：
album可选-
包含待播放媒体的专辑或合集的名称。默认为空字符串（
""）。 artist可选-
包含待播放媒体的艺术家、乐队、创作者等的名称。默认为空字符串（
""）。 artwork可选-
表示与正在播放的媒体相关联的图像的对象数组，默认值为空数组。对象结构如下：
chapterInfo可选-
包含
ChapterInformation对象实例的数组，这些实例表示与媒体相关的章节信息元数据。对象结构如下：artwork可选-
包含
artwork对象的数组（参见上文），这些对象代表与该章节相关的图片。如果省略此属性，artwork默认为空数组。 startTime可选-
表示章节开始时间的秒数。如果缺省，
startTime的默认值为0。 title可选-
表示章节标题的字符串。如果缺省，
title默认为空字符串（""）。
title可选-
待播放媒体的标题。默认为空字符串（
""）。
示例
以下示例使用正确的元数据格式创建了一个新的 MediaMetadata 对象。
js
if ("mediaSession" in navigator) {
navigator.mediaSession.metadata = new MediaMetadata({
title: "Unforgettable",
artist: "纳特·金·科尔",
album: "终极合集（重制版）",
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",
},
],
});
}
规范
| 规范 |
|---|
| Media Session # dom-mediametadata-mediametadata |