The Media Playback cluster (0x0506) is a Matter cluster that Controls media playback including play, pause, seek, and playback speed.. It defines 15 commands and 13 attributes and is mandatory for 5 device types.
Media Playback 0x0506
Controls media playback including play, pause, seek, and playback speed.
Spec History
This cluster's ClusterRevision across the Matter releases it has shipped in. Click a version to inspect the cluster as it existed in that release.
Attributes 13
Commands 15
Features 5
| Code | Name | Type | Flags |
|---|---|---|---|
| 0x0000 |
CurrentState
max 0x03
|
PlaybackStateEnum | |
| 0x0001 |
StartTime
nullable
|
epoch_us | Optional |
| 0x0002 |
Duration
nullable
|
int64u | Optional |
| 0x0003 |
SampledPosition
nullable
|
PlaybackPositionStruct | Optional |
| 0x0004 |
PlaybackSpeed
default 0
|
single | Optional |
| 0x0005 |
SeekRangeEnd
nullable
|
int64u | Optional |
| 0x0006 |
SeekRangeStart
nullable
|
int64u | Optional |
| 0x0007 |
ActiveAudioTrack
nullable
|
TrackStruct | Optional |
| 0x0008 |
AvailableAudioTracks
nullable
|
array | Optional |
| 0x0009 |
ActiveTextTrack
nullable
|
TrackStruct | Optional |
| 0x000A |
AvailableTextTracks
nullable
|
array | Optional |
| 0x000B |
AvailableCommands
nullable
|
array | Provisional |
| 0x000C |
ContentInfo
nullable
|
ContentInfoStruct | Provisional |
| Code | Name | Direction | Parameters |
|---|---|---|---|
| 0x00 |
Play
This command is used to start playback of the media.
|
client→server | None |
| 0x01 |
Pause
This command is used to pause playback of the media.
|
client→server | None |
| 0x02 |
Stop
This command is used to stop playback of the media.
|
client→server | None |
| 0x03 |
StartOver
Optional This command is used to start playback of the media from the beginning.
|
client→server | None |
| 0x04 |
Previous
Optional This command is used to go back to the previous media playback item.
|
client→server | None |
| 0x05 |
Next
Optional This command is used to go to the next media playback item.
|
client→server | None |
| 0x06 |
Rewind
Optional This command is used to rewind the media.
|
client→server |
AudioAdvanceUnmuted: boolean |
| 0x07 |
FastForward
Optional This command is used to fast forward the media.
|
client→server |
AudioAdvanceUnmuted: boolean |
| 0x08 |
SkipForward
Optional This command is used to skip forward in the media.
|
client→server |
DeltaPositionMilliseconds: int64u |
| 0x09 |
SkipBackward
Optional This command is used to skip backward in the media.
|
client→server |
DeltaPositionMilliseconds: int64u |
| 0x0A |
PlaybackResponse
This command is used to indicate the status of the command that was issued by the client.
|
server→client |
Status: StatusEnum, Data: char_string |
| 0x0B |
Seek
Optional This command is used to seek to a specific position in the media.
|
client→server |
Position: int64u |
| 0x0C |
ActivateAudioTrack
Optional This command is used to activate a specific Audio Track for the media being played.
|
client→server |
TrackID: char_string, AudioOutputIndex: int8u |
| 0x0D |
ActivateTextTrack
Optional This command is used to activate a specific Text Track for the media being played.
|
client→server |
TrackID: char_string |
| 0x0E |
DeactivateTextTrack
Optional This command is used to deactivate a specific Text Track for the media being played.
|
client→server | None |
AdvancedSeek
(AS)
bit 0
Advanced media seeking
VariableSpeed
(VS)
bit 1
Variable speed playback
TextTracks
(TT)
bit 2
Text Tracks
AudioTracks
(AT)
bit 3
Audio Tracks
AudioAdvance
(AA)
bit 4
Can play audio during fast and slow playback speeds
Device Types Using This Cluster
Device types in the Matter spec that reference this cluster
Devices Implementing This Cluster
5 devices in the survey implement this cluster