Navigator: mediaSession 屬性

Baseline 已廣泛支援

此功能已成熟,並可在多種裝置和瀏覽器版本上執行。自 2021 年 9 月起,所有瀏覽器均已支援此功能。

Navigator 介面的只讀屬性 mediaSession 返回一個 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

瀏覽器相容性