Improve media_player documentation

This commit is contained in:
Robbie Trencheny 2016-03-25 23:12:33 -07:00
parent 68bfa012da
commit 62ce8217c3

View File

@ -15,29 +15,18 @@ Interacts with media players on your network. Please check the sidebar for a ful
### {% linkable_title Media control services %}
Available services: `turn_off`, `volume_up`, `volume_down`, `media_play_pause`, `media_play`, `media_pause`, `media_next_track`
Available services: `turn_off`, `volume_up`, `volume_down`, `media_play_pause`, `media_pause`, `media_next_track`
| Service data attribute | Optional | Description |
| ---------------------- | -------- | ----------- |
| `entity_id` | yes | Target a specific media player. Defaults to all.
### {% linkable_title Media play services %}
### {% linkable_title Playing Media %}
There are three services to start playing YouTube video's on the media player.
#### {% linkable_title Service `media_player/play_youtube_video` %}
Service to start playing a YouTube video on the media player.
| Service data attribute | Optional | Description |
| ---------------------- | -------- | ----------- |
| `entity_id` | yes | Target a specific media player. Defaults to all.
| `video` | no | YouTube video to be played, ie. `L0MK7qz13bU`
#### {% linkable_title Service `media_player/start_fireplace` and `media_player/start_epic_sax` %}
Will either start a fireplace or Epic Sax Guy 10h on the media player.
#### {% linkable_title 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 component 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`.