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
The compatibility table in this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.
Desktop | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
MediaMetadata() constructor | Chrome Full support 57 | Edge No support No | Firefox Full support 71 | IE No support No | Opera Full support Yes | Safari ? | WebView Android No support No | Chrome Android Full support 57 | Firefox Android ? | Opera Android No support No | Safari iOS ? | Samsung Internet Android Full support 7.0 |
Legend
- Full support
- Full support
- No support
- No support
- Compatibility unknown
- Compatibility unknown
- Experimental. Expect behavior to change in the future.
- Experimental. Expect behavior to change in the future.