MediaMetadata: MediaMetadata() コンストラクター

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

MediaMetadata() コンストラクターは、新しい MediaMetadata オブジェクトを作成します。

構文

js
new MediaMetadata()
new MediaMetadata(metadata)

引数

metadata 省略可

メタデータ引数は次の通りです。

title 省略可

再生されるメディアのタイトル。既定では空文字列 ("") です。

artist 省略可

再生されるメディアのアーティスト、グループ、作者の名前。既定では空文字列 ("") です。

album 省略可

再生されるメディアを含むアルバムまたはコレクションの名前。既定では空文字列 ("") です。

artwork 省略可

再生メディアに関連付けられた画像を表すオブジェクトの配列 (Array) で、既定値は空配列です。オブジェクトの構造は次の通りです。

src

ユーザーエージェントが画像データを取得する URL。

sizes 省略可

ユーザーエージェントが単一の画像を変倍する必要がないように、リソースを複数のサイズで指定します。既定では空文字列 ("") です。

type 省略可

ユーザーエージェントが対応していない型の画像を無視するための MIME タイプのヒント。ただし、ユーザーエージェントは画像をダウンロードした後、MIME タイプスニッフィングを使用してその型を決定することができます。既定では空文字列 ("") です。

例

以下の例では、正しい形式のメタデータを使用して新しい MediaMetadata オブジェクトを作成します。

js
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",
      },
    ],
  });
}

仕様書

Specification
Media Session
# dom-mediametadata-mediametadata

ブラウザーの互換性

BCD tables only load in the browser