Vega Media Controls attributes and features

Open Beta Documentation Amazon offers this technical documentation as part of a pre-release, open beta. The features described might change as Amazon receives feedback and iterates on the features. For the most current feature information, see the latest Release Notes.

The commands and attributes your app receives are determined by three mechanisms in your manifest configuration: core commands and attributes (always delivered without any configuration), optional commands (individually enabled via command_options), and feature-gated commands and attributes (enabled in groups via features). The sections below describe each command and attribute and how it is enabled.

For implementation details and code examples, see Get started with Vega Media Controls.

Core attributes

These attributes are always available without any additional manifest configuration:

ActiveMediaId
ActiveVideo
AvailableActions
AvailableBackwardSkip
AvailableForwardSkip
AvailableRatings
AvailableSpeeds
CurrentRating
CurrentState
CustomControlsState
MediaSessionStates
RepeatMode
ShuffleEnabled

Feature-gated attributes

These attributes are only available when their corresponding feature is included in the features array:

Attribute	Required Feature
Duration	`AdvancedSeek`
PlaybackSpeed	`AdvancedSeek`
SampledPosition	`AdvancedSeek`
SeekRangeEnd	`AdvancedSeek`
SeekRangeStart	`AdvancedSeek`
StartTime	`AdvancedSeek`
ActiveAudioTrack	`AudioTracks`
AvailableAudioTracks	`AudioTracks`
ActiveTextTrack	`TextTracks`
AvailableTextTracks	`TextTracks`

Core commands

These commands are always available without any additional manifest configuration:

EnableShuffle
GetMediaSessionState
GetMetadata
Pause
Play
SendCustomAction
SetAudioVolume
SetPlaybackSpeed
SetRating
SetRepeatMode
Stop
TogglePlayPause

Feature-gated commands

These commands are only available when their corresponding feature is included in the features array. If you don't include the feature, your app doesn't receive these commands even if you implement the handlers.

Command	Required Feature
FastForward	`VariableSpeed`
Rewind	`VariableSpeed`
Seek	`AdvancedSeek`
ActivateAudioTrack	`AudioTracks`
ActivateTextTrack	`TextTracks`
DeactivateTextTrack	`TextTracks`

Optional commands

The following commands can be individually enabled by adding them to the command_options array in your manifest. If you don't list a command here, your app won't receive requests for it:

Next
Previous
SkipBackward
SkipForward
StartOver

Features

You can specify the following features for Vega Media Controls. Each feature enables a group of related commands and attributes.

AdvancedSeek — Enables seek functionality and time-based playback attributes.
- provided attributes
  - Duration
  - PlaybackSpeed
  - SampledPosition
  - SeekRangeEnd
  - SeekRangeStart
  - StartTime
- provided commands
  - Seek
AudioTracks — Enables audio track selection.
- provided attributes
  - ActiveAudioTrack
  - AvailableAudioTracks
- provided commands
  - ActivateAudioTrack
TextTracks — Enables text track (subtitle/caption) display.
- provided attributes
  - ActiveTextTrack
  - AvailableTextTracks
- provided commands
  - ActivateTextTrack
  - DeactivateTextTrack
VariableSpeed — Enables fast forward and rewind commands. You must include this feature to receive FastForward and Rewind events.
- provided commands
  - FastForward
  - Rewind

Last updated: Mar 31, 2026