MediaMetadata.MediaMetadata()

This is an experimental technology
Check the Browser compatibility table carefully before using this in production.

The MediaMetadata() constructor creates a new MediaMetadata object.

Syntax

var mediaMetadata = new MediaMetadata([metadata])

Parameters

metadata Optional

The metadata parameters are as follows:
  • title: The title of the media to be played.
  • artist: The name of the artist, group, creator, etc. of the media to be played.
  • album: The name of the album, or collection, containing the media to be played.
  • artwork: An array of images associated with the playing media.

Example

The following example creates a new media session and assigns action handlers to it:

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() {});
}

Specifications

Specification Status Comment
Media Session Standard
The definition of 'MediaMetadata()' in that specification.
Draft Initial definition.

Browser compatibility

FeatureChromeEdgeFirefoxInternet ExplorerOperaSafari
Basic support No ? ? ? No ?
FeatureAndroid webviewChrome for AndroidEdge mobileFirefox for AndroidOpera AndroidiOS SafariSamsung Internet
Basic support No57 ? ? No ? ?

Document Tags and Contributors

Contributors to this page: connorshea, david_ross, jpmedley
Last updated by: connorshea,