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-19 15:26:59 +00:00
Code Issues Packages Projects Releases Wiki Activity

Document HEOS groups (#20428)

Browse Source
This commit is contained in:
Dan Klaffenbach 2021-11-29 14:11:12 +01:00 committed by GitHub
parent b12850077f
commit 339a8fbe7c
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 26 additions and 1 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

27
source/_integrations/heos.markdown
View File

@ -21,6 +21,7 @@ The HEOS integration adds support for [HEOS](https://www.denon.com/en-gb/shop/am
- Control play mode (play, pause, stop, next and previous), volume, mute and shuffle
- Clear playlist
- Select source from device physical inputs and HEOS favorites
- Create HEOS groups
{% include integrations/config_flow.md %}
@ -114,9 +115,33 @@ media_content_id: "http://path.to/stream.mp3"
| `media_content_type` | no | Set to the value `url`
| `media_content_id` | no | The full URL to the stream
### Service `media_player.join`
For grouping HEOS media players together for synchronous playback you can use the `media_player.join` service. With the example service data payload down below you'll expand playback of `media_player.office` to the `media_player.kitchen` and `media_player.bathroom` players. Please note that all of the media players need to be HEOS players.
```yaml
entity_id: media_player.office
group_members:
- media_player.kitchen
- media_player.bathroom
```
| Service data attribute | Optional | Description |
| ---------------------- | -------- | ----------- |
| `entity_id` | yes | The media player entity whose playback will be expanded to the players specified in `group_members`.
| `group_members` | no | The player entities which will be synced with the playback from `entity_id`.
### Service `media_player.unjoin`
For removing a HEOS player from a group you can use the `media_player.unjoin` service.
| Service data attribute | Optional | Description |
| ---------------------- | -------- | ---------------------------------------------------- |
| `entity_id` | yes | Unjoin this media player from any player groups. |
## Notes
- HEOS groups are not currently supported.
- Receivers with multiple zones are represented as a single media player. They will be turned on when playback is started, but cannot be turned off by the integration at this time.
## Troubleshooing