From daf25516904f2886a3cdb65d3d0b1d0afc558f8b Mon Sep 17 00:00:00 2001
From: Chris Talkington <chris@talkingtontech.com>
Date: Sun, 16 Jan 2022 11:00:52 -0600
Subject: [PATCH] Add play media URL support to roku (#21185)

---
 source/_integrations/roku.markdown | 27 +++++++++++++++++++++++++++
 1 file changed, 27 insertions(+)

diff --git a/source/_integrations/roku.markdown b/source/_integrations/roku.markdown
index 737391f582a..6a5fd0fde6b 100644
--- a/source/_integrations/roku.markdown
+++ b/source/_integrations/roku.markdown
@@ -127,6 +127,33 @@ action:
       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
 
 The `media_player.play_media` service may be used to deep link to content within an application.