MediaMetadata: MediaMetadata() 建構函式

可用性有限

此特性不是基線特性，因為它在一些最廣泛使用的瀏覽器中不起作用。

MediaMetadata() 建構函式建立一個新的 MediaMetadata 物件。

語法

new MediaMetadata()
new MediaMetadata(metadata)

引數

metadata 可選

metadata 引數如下：

album 可選

正在播放的媒體所屬的專輯或合集的名稱。預設為空字串 ("")。

artist 可選

正在播放的媒體的藝術家、樂隊或創作者的名稱。預設為空字串 ("")。

artwork 可選

一個 Array，包含表示正在播放媒體相關聯的影像的物件，預設為空陣列。物件結構為：

src: 使用者代理從中獲取影像資料的 URL。
sizes 可選: 指定多種尺寸的資源，這樣使用者代理就無需縮放單個影像。預設為空字串 ("")。
type 可選: 使用者代理的 MIME 型別提示，允許它忽略它不支援的型別影像。但是，使用者代理仍可能在下載影像後使用 MIME 型別嗅探來確定其型別。預設為空字串 ("")。

chapterInfo 可選

一個 ChapterInformation 物件例項的陣列，表示與媒體關聯的章節資訊元資料。物件結構為：

artwork 可選: 一個 artwork 物件（見上文）的 Array，表示與章節關聯的影像。如果省略，artwork 預設為空陣列。
startTime 可選: 一個表示章節開始時間的數字（秒）。如果省略，startTime 預設為 0。
title 可選: 一個表示章節標題的字串。如果省略，title 預設為空字串 ("")。

title 可選

正在播放的媒體的標題。預設為空字串 ("")。

示例

以下示例使用正確的元資料格式建立了一個新的 MediaMetadata 物件。

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-mediametadata-mediametadata

瀏覽器相容性

幫助改進 MDN

瞭解如何貢獻

此頁面最後修改於 2025年6月23日，由 MDN 貢獻者。

在 GitHub 上檢視此頁面 • 報告此內容的某個問題