This is an experimental technologyCheck 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 MediaMetadata
object using the correct format of metadata.
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' },
]
});
}
Specifications
Specification | Status | Comment |
Media Session StandardThe 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.
Update compatibility data on GitHub
Desktop | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
|
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.
MediaMetadata.MediaMetadata() by Mozilla Contributors is licensed under CC-BY-SA 2.5.