Media Player — media_player v1

Anything that originates content: a streamer, a disc player, a cable box, a music service. It is a source in the signal graph — a room's watch or listen names one of these.

Capabilities

Declared in the driver manifest under [[proxy]] capabilities. Anything not declared takes the default below.

Capability	Type	Default	Meaning
has_apps	bool	false	Installed applications can be listed and launched
has_browse	bool	false	Content can be listed and selected by id
has_dpad	bool	false	Cursor navigation for an on-screen UI
has_metadata	bool	false	Reports title/artist/art
has_number_keys	bool	false
has_playlists	bool	false
has_scan	bool	false	Fast forward / rewind
has_search	bool	false
has_seek	bool	false
has_shuffle_repeat	bool	false
has_skip	bool	false
has_transport	bool	true	Play/pause/stop
is_audio_source	bool	true
is_video_source	bool	false

Commands

dpad

Only present when has_dpad is declared true.

Parameter	Type	Notes
key	one of up · down · left · right · select · back · menu · home · info

launch_app

Only present when has_apps is declared true.

Open an installed application. The valid names are whatever apps reports for this device.

Parameter	Type	Notes
app	string
content_id	string (optional)	Deep link to a specific title

pause

No parameters.

play

No parameters.

play_item

Only present when has_browse is declared true.

Play a content id previously returned by browse or search

Parameter	Type	Notes
id	string

scan_forward

Only present when has_scan is declared true.

No parameters.

scan_reverse

Only present when has_scan is declared true.

No parameters.

search

Only present when has_search is declared true.

Parameter	Type	Notes
query	string

seek

Only present when has_seek is declared true.

Parameter	Type	Notes
position_ms	u32

set_repeat

Only present when has_shuffle_repeat is declared true.

Parameter	Type	Notes
mode	one of off · one · all

set_shuffle

Only present when has_shuffle_repeat is declared true.

Parameter	Type	Notes
shuffle	bool

skip_back

Only present when has_skip is declared true.

No parameters.

skip_forward

Only present when has_skip is declared true.

No parameters.

stop

No parameters.

Notifications

app_changed

Only present when has_apps is declared true.

Parameter	Type	Notes
app	string

apps_changed

Only present when has_apps is declared true.

The installed application list, read from the device.

Parameter	Type	Notes
app_icons	string[] (optional)	One artwork URL per entry in apps, same order, empty string where the device has none. A
control surface draws the channel the way its owner recognises it — by its logo, not its name.

These are addresses on the device, and they stay there: a client asks the controller for /artwork?binding=..&i=.. and the controller fetches the picture. That is what makes this work from a phone that is not on the television's network, and it means a driver only has to say where its artwork lives, not serve it. | | apps | string[] | |

metadata_changed

Only present when has_metadata is declared true.

Parameter	Type	Notes
album	string (optional)
art_url	string (optional)
artist	string (optional)
duration_ms	u32 (optional)
title	string (optional)

online_changed

Parameter	Type	Notes
online	bool

position_changed

Only present when has_seek is declared true.

Parameter	Type	Notes
position_ms	u32

transport_changed

Parameter	Type	Notes
state	one of playing · paused · stopped · buffering

State

Last-known values core keeps for a binding of this proxy.

Key	Type	Meaning
app	string	Application currently in the foreground
app_icons	string[]	Artwork for apps, one per entry, same order
apps	string[]	Installed applications, as read from the device
artist	string
online	bool
title	string
transport	string