home-assistant.io/source/_components/media_player.markdown
Franck Nijhof 1833c32a2c Cleans up front matter (#9835)
* Sets front matter defaults

* Removes default front matter from section templates/pages

* Removes default front matter from addon pages

* Removes default front matter from integration pages

* Removes default front matter from posts

* Removes default front matter from docs pages

* Removes default front matter from other pages

* Fixes blog category pages
2019-07-11 14:35:08 -07:00

4.7 KiB

title, description, logo, ha_category, ha_qa_scale, ha_release
title description logo ha_category ha_qa_scale ha_release
Media Player Instructions on how to setup your media players with Home Assistant. home-assistant.png
Media Player
internal 0.7

Interacts with media players on your network.

Services

Media control services

Available services: turn_on, turn_off, toggle, volume_up, volume_down, volume_set, volume_mute, media_play_pause, media_play, media_pause, media_stop, media_next_track, media_previous_track, clear_playlist, shuffle_set

Service data attribute Optional Description
entity_id yes Target a specific media player. Defaults to all.

Service media_player.volume_mute

Service data attribute Optional Description
entity_id yes Target a specific media player. Defaults to all.
is_volume_muted no True/false for mute/unmute

Service media_player.volume_set

Service data attribute Optional Description
entity_id yes Target a specific media player. Defaults to all.
volume_level no Float for volume level. Range 0..1

Service media_player.media_seek

Service data attribute Optional Description
entity_id yes Target a specific media player. Defaults to all.
seek_position no Position to seek to. The format is platform dependent.

Service media_player.play_media

Service data attribute Optional Description
entity_id yes Target a specific media player. Defaults to all.
media_content_id no A media identifier. The format of this is integration dependent. For example, you can provide URLs to Sonos and Cast but only a playlist ID to iTunes.
media_content_type no A media type. Must be one of music, tvshow, video, episode, channel or playlist. For example, to play music you would set media_content_type to music.

Service media_player.select_source

Service data attribute Optional Description
entity_id yes Target a specific media player. Defaults to all.
source no Name of the source to switch to. Platform dependent.

Service media_player.select_sound_mode

Currently only supported on Denon AVR and Songpal.

Service data attribute Optional Description
entity_id no Target a specific media player. For example media_player.marantz
sound_mode no Name of the sound mode to switch to. Platform dependent.

Service media_player.shuffle_set

Currently only supported on Spotify, MPD, Kodi, Squeezebox and Universal.

Service data attribute Optional Description
entity_id no Target a specific media player. For example media_player.spotify
shuffle no true/false for enabling/disabling shuffle