Add play media URL support to roku (#21185)

This commit is contained in:
Chris Talkington 2022-01-16 11:00:52 -06:00 committed by GitHub
parent 3592acddbd
commit daf2551690
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23

View File

@ -127,6 +127,33 @@ action:
media_content_type: channel media_content_type: channel
``` ```
## Play on Roku
The `media_player.play_media` service may be used to send media URLs (primarily videos) for direct playback on your device. This feature makes use of the built-in PlayOnRoku application.
| Service data attribute | Optional | Description | Example |
| ---------------------- | -------- | ----------- | ------- |
| `entity_id` | no | Target a specific media player. To target all media players, use `all`. | |
| `media_content_id` | no | A media URL. | http://commondatastorage.googleapis.com/gtv-videos-bucket/sample/BigBuckBunny.mp4
| `media_content_type` | no | A media type. | `url`
| `extra.format` | no | A media format. Should be one of `mp4` (supports mov and m4v), `wma`, `mp3`, `hls`, `ism` (smooth streaming), `dash` (MPEG-DASH), `mkv`, `mka`, `mks` | `mp4`
| `extra.name` | yes | A name for the media. | Big Buck Bunny
### Example
```yaml
action:
- service: media_player.play_media
target:
entity_id: media_player.roku
data:
media_content_id: http://commondatastorage.googleapis.com/gtv-videos-bucket/sample/BigBuckBunny.mp4
media_content_type: url
extra:
format: mp4
name: Big Buck Bunny
```
## Content Deeplinking ## Content Deeplinking
The `media_player.play_media` service may be used to deep link to content within an application. The `media_player.play_media` service may be used to deep link to content within an application.