Amazon Developer

Console

as

Settings
Sign out
Notifications
Alexa
Amazon Appstore
Ring
AWS
Documentation
Support
Contact Us
My Cases

Console

as

Get Started
Design and Develop
Publish
Reference
Support
Native
Skip to main content

​
Data object MediaSessionState

interface struct MediaSessionState
Describes the state of a media session. This type includes the playback state, media item information, capabilities, the current playlist state, and any available state for custom controls. A media control server can have multiple media sessions and notifies updates to each media session state by calling [IMediaControlServerAsync#updateMediaSessionStates]. Clients can obtain the media session state by calling [IMediaControlClientAsync#getSessionState].

​
Fields

​
id

MediaSessionId* — Required
The unique id associated with this media session state. This id is unique in the context of the media control server.

​
playbackState

PlaybackState* — Required
The current playback state for the media session.

​
mediaInfo

MediaInfo? — Optional
The information for the currently selected or playing media. This may be null if no media is currently selected.

​
capabilities

Capabilities* — Required
The current capabilities of this media session. A client can inspect the capabilites to understand what this media session can support and adapt its UI or functionality accordingly.

​
playlistState

PlaylistState? — Optional
The state of the playlist associated with this media session if any.

​
controls

Control[] — Required
A list of custom controls. A media session can advertise the state of any custom control that is not expressable by any of the types in this IDL.
Last modified on October 29, 2026