jeans/home-assistant.io
jeans/home-assistant.io
1
0
Fork 0
mirror of https://github.com/home-assistant/home-assistant.io.git synced 2025-07-23 09:17:06 +00:00
Code Issues Packages Projects Releases Wiki Activity

Add a section about general Chromecast use cases (#15812)

Browse Source 
Co-authored-by: Franck Nijhof <frenck@frenck.nl>
This commit is contained in:
gemolnar 2021-01-25 16:02:44 +01:00 committed by GitHub
parent 089fbb0f5b
commit 6fc2535766
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 61 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

61
source/_integrations/cast.markdown
View File

@ -104,6 +104,67 @@ To cast media directly from a configured Plex server, set the fields [as documen
media_content_id: 'plex://{"library_name": "Movies", "title": "Groundhog Day"}'
```
### Play (almost) any kind of media
Chromecasts can play many kinds of modern [media (image/audio/video) formats](https://developers.google.com/cast/docs/media). As a rule of thumb, if a Chrome browser can play a media file a Chromecast will be able to handle that too.
The media needs to be accessible via HTTP(S). Chromecast devices do not support other protocols like DLNA or playback from an SMB file share.
You can play MP3 streams like net radios, FLAC files or videos from your local network with the `media_player.play_media` service, as long as the media is accessible via HTTP(S). You need to set the `media_content_id` to the media URL and `media_content_type` to a matching content type.
```yaml
# Play a video file from the local network:
service: media_player.play_media
data:
entity_id: media_player.chromecast
media_content_type: 'video'
media_content_id: 'http://192.168.0.100/movies/sample-video.mkv'
```
```yaml
# Show a jpeg image:
service: media_player.play_media
data:
entity_id: media_player.chromecast
media_content_type: 'image/jpeg'
media_content_id: 'http://via.placeholder.com/1024x600.jpg/0B6B94/FFFFFF/?text=Hello,%20Home%20Assistant!'
```
Extra media metadata (for example title, subtitle, artist or album name) can be passed into the service and that will be shown on the Chromecast display.
For the possible metadata types and values check [Google cast documentation > MediaInformation > metadata field](https://developers.google.com/cast/docs/reference/messages#MediaInformation).
```yaml
# Play a movie from the internet, with extra metadata provided:
service: media_player.play_media
data:
entity_id: media_player.chromecast
media_content_type: 'video/mp4'
media_content_id: 'http://commondatastorage.googleapis.com/gtv-videos-bucket/sample/BigBuckBunny.mp4'
extra:
metadata:
metadataType: 1
title: 'Big Buck Bunny'
subtitle: 'By Blender Foundation, Licensed under the Creative Commons Attribution license'
images:
- url: 'https://peach.blender.org/wp-content/uploads/watchtrailer.gif'
```
```yaml
# Play a netradio, with extra metadata provided:
service: media_player.play_media
data:
entity_id: media_player.chromecast
media_content_type: 'audio/mp3'
media_content_id: 'http://stream.tilos.hu:8000/tilos'
extra:
metadata:
metadataType: 3
title: 'Radio TILOS'
artist: 'LIVE'
images:
- url: 'https://tilos.hu/images/kockalogo.png'
```
## Advanced use
### Manual configuration