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-26 02:37:03 +00:00
Code Issues Packages Projects Releases Wiki Activity

Clarify use of Sonos favorites sensor in service calls (#23952)

Browse Source
This commit is contained in:
dreed47 2022-09-18 15:41:02 -04:00 committed by GitHub
parent f489b61691
commit 02012a6745
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 12 additions and 1 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

13
source/_integrations/sonos.markdown
View File

@ -69,7 +69,18 @@ The microphone can only be enabled/disabled from physical buttons on the Sonos d
The favorites sensor provides the names and `media_content_id` values for each of the favorites saved to My Sonos in the native Sonos app. This sensor is intended for users that need to access the favorites in a custom template. For most users, accessing favorites by using the Media Browser functionality and "Play media" script/automation action is recommended. The favorites sensor provides the names and `media_content_id` values for each of the favorites saved to My Sonos in the native Sonos app. This sensor is intended for users that need to access the favorites in a custom template. For most users, accessing favorites by using the Media Browser functionality and "Play media" script/automation action is recommended.
If using the provided `media_content_id` with the `media_player.play_media` service, the `media_content_type` must be set to "favorite_item_id". When calling the `media_player.play_media` service, the `media_content_type` must be set to "favorite_item_id" and the `media_content_id` must be set to just the key portion of the favorite item.
Example service call:
```yaml
service: media_player.play_media
target:
entity_id: media_player.sonos_speaker1
data:
media_content_type: "favorite_item_id"
media_content_id: "FV:2/31"
```
Example templates: Example templates: