mirror of
https://github.com/home-assistant/home-assistant.io.git
synced 2025-07-22 16:56:50 +00:00
Add content deeplinking support to roku (#21170)
This commit is contained in:
parent
97ac280f54
commit
d7e40cd12c
@ -98,9 +98,6 @@ The API calls are like this:
|
|||||||
```txt
|
```txt
|
||||||
GET http://ROKU_IP:8060/query/apps
|
GET http://ROKU_IP:8060/query/apps
|
||||||
POST http://ROKU_IP:8060/launch/APP_ID
|
POST http://ROKU_IP:8060/launch/APP_ID
|
||||||
|
|
||||||
YouTube example:
|
|
||||||
POST http://YOUR_ROKU_IP:8060/launch/837?contentID=YOUR_YOUTUBE_VIDEOS_CONTENT_ID&MediaType=live
|
|
||||||
```
|
```
|
||||||
|
|
||||||
One method of performing the GET request is to open `http://ROKU_IP:8060/query/apps` in your web browser of choice. The Roku will return an XML-formatted list of available channels, including their full name and appID.
|
One method of performing the GET request is to open `http://ROKU_IP:8060/query/apps` in your web browser of choice. The Roku will return an XML-formatted list of available channels, including their full name and appID.
|
||||||
@ -130,6 +127,44 @@ action:
|
|||||||
media_content_type: channel
|
media_content_type: channel
|
||||||
```
|
```
|
||||||
|
|
||||||
|
## Content Deeplinking
|
||||||
|
|
||||||
|
The `media_player.play_media` service may be used to deep link to content within an 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 identifier. | 291097
|
||||||
|
| `media_content_type` | no | A media type. | channel
|
||||||
|
| `extra.content_id` | no | A unique content identifier passed to app. | 8e06a8b7-d667-4e31-939d-f40a6dd78a88
|
||||||
|
| `extra.media_type` | no | A media type passed to app. Should be one of `movie`, `episode`, `season`, `series`, `shortFormVideo`, `special`, `live` | movie
|
||||||
|
|
||||||
|
### Example
|
||||||
|
|
||||||
|
```yaml
|
||||||
|
action:
|
||||||
|
- service: media_player.play_media
|
||||||
|
target:
|
||||||
|
entity_id: media_player.roku
|
||||||
|
data:
|
||||||
|
media_content_id: 291097
|
||||||
|
media_content_type: app
|
||||||
|
extra:
|
||||||
|
content_id: 8e06a8b7-d667-4e31-939d-f40a6dd78a88
|
||||||
|
media_type: movie
|
||||||
|
```
|
||||||
|
|
||||||
|
### Obtaining Content IDs
|
||||||
|
|
||||||
|
Content IDs are unique to each streaming service and vary in format but are often part of the video webpage URL. Here are some examples:
|
||||||
|
|
||||||
|
| Service | App ID | URL Format | Content ID | Media Type
|
||||||
|
| ------- | ------ | ---------- | ---------- | ---------- |
|
||||||
|
| Disney Plus | 291097 | disneyplus.com/video/8e06a8b7-d667-4e31-939d-f40a6dd78a88 | 8e06a8b7-d667-4e31-939d-f40a6dd78a88 | movie
|
||||||
|
| Hulu | 2285 | hulu.com/series/american-dad-977c8e25-cde0-41b7-80ce-e746f2d2093f | american-dad-977c8e25-cde0-41b7-80ce-e746f2d2093f | series
|
||||||
|
| Spotify | 22297 | open.spotify.com/playlist/5xddIVAtLrZKtt4YGLM1SQ | spotify:playlist:5xddIVAtLrZKtt4YGLM1SQ | playlist
|
||||||
|
| YouTube | 837 | youtu.be/6ZMXE5PXPqU | 6ZMXE5PXPqU | live
|
||||||
|
|
||||||
## Services
|
## Services
|
||||||
|
|
||||||
### Service `roku.search`
|
### Service `roku.search`
|
||||||
|
Loading…
x
Reference in New Issue
Block a user