mirror of
https://github.com/home-assistant/home-assistant.io.git
synced 2025-07-23 17:27:19 +00:00
Describe new Plex play_media syntax for movies (#14378)
This commit is contained in:
parent
833da896c6
commit
2269d9eaec
@ -127,21 +127,50 @@ media_content_type: EPISODE
|
||||
media_content_id: '{ "library_name": "Kid TV", "show_name": "Sesame Street", "shuffle": "1" }'
|
||||
```
|
||||
|
||||
#### Video
|
||||
#### Movie
|
||||
|
||||
| Service data attribute | Description |
|
||||
| ---------------------- | ------------------------------------------------------------------------------------------------------- |
|
||||
| `entity_id` | `entity_id` of the client |
|
||||
| `media_content_id` | Quoted JSON containing:<br/><ul><li>`library_name` (Required)</li><li>`video_name` (Required)</li></ul> |
|
||||
| `media_content_type` | `VIDEO` |
|
||||
| `media_content_id` | Quoted JSON containing:<br/><ul><li>`library_name` (Required)</li><li>`title` (Required)</li><li>`<SEARCH_KEY>` (optional)</li></ul> |
|
||||
| `media_content_type` | `movie` |
|
||||
|
||||
##### Example:
|
||||
For movies it's usually sufficient to provide the title. However, if the title you provide has multiple matches (such as with remakes), more search keys may be necessary. These optional keys can be included in the `media_content_id` JSON payload to restrict the search:
|
||||
|
||||
* `unwatched`: Restrict search to unwatched items only (`True`, `False`)
|
||||
* `actor`: Restrict search for movies that include a specific actor
|
||||
* `collection`: Restrict search within a named Plex collection ("Back to the Future", "Indiana Jones")
|
||||
* `contentRating`: Restrict search to a specific content rating ("PG", "R")
|
||||
* `country`: Restrict search to a specific country of origin
|
||||
* `decade`: Restrict search to a specific decade ("1960", "2010")
|
||||
* `director`: Restrict search to a specific director
|
||||
* `genre`: Restrict search to a specific genre ("Animation", "Drama", "Sci-Fi")
|
||||
* `resolution`: Restrict search to a specific video resolution (480, 720, 1080, "4k")
|
||||
* `year`: Restrict search to a specific year
|
||||
|
||||
##### Examples:
|
||||
```yaml
|
||||
entity_id: media_player.plex_player
|
||||
media_content_type: VIDEO
|
||||
media_content_id: '{ "library_name": "Adult Movies", "video_name": "Blade" }'
|
||||
media_content_type: movie
|
||||
media_content_id: '{ "library_name": "Adult Movies", "title": "Blade" }'
|
||||
```
|
||||
|
||||
```yaml
|
||||
entity_id: media_player.plex_player
|
||||
media_content_type: movie
|
||||
media_content_id: '{ "library_name": "Adult Movies", "title": "The Manchurian Candidate", year=1962 }'
|
||||
# Would find the original instead of the 2004 remake
|
||||
```
|
||||
|
||||
"Lazy" searches are also possible:
|
||||
```yaml
|
||||
entity_id: media_player.plex_player
|
||||
media_content_type: movie
|
||||
media_content_id: '{ "library_name": "Adult Movies", "title": "die hard", year=1995 }'
|
||||
# Would find the sequel, "Die Hard: With a Vengeance"
|
||||
```
|
||||
|
||||
|
||||
### Compatibility
|
||||
|
||||
| Client | Limitations |
|
||||
|
Loading…
x
Reference in New Issue
Block a user