From 71a84df8642d215deafbfc0b8d57203d80ff5e03 Mon Sep 17 00:00:00 2001 From: Markus Jacobsen Date: Tue, 18 Jun 2024 14:05:46 +0200 Subject: [PATCH] Add Tidal play_media documentation to Bang & Olufsen (#33302) * Add Tidal play_media documentation * Update source/_integrations/bang_olufsen.markdown Co-authored-by: Dave T <17680170+davet2001@users.noreply.github.com> --------- Co-authored-by: Dave T <17680170+davet2001@users.noreply.github.com> --- source/_integrations/bang_olufsen.markdown | 48 ++++++++++++++++++++-- 1 file changed, 44 insertions(+), 4 deletions(-) diff --git a/source/_integrations/bang_olufsen.markdown b/source/_integrations/bang_olufsen.markdown index 6acce0838d3..4cf90fa4ef7 100644 --- a/source/_integrations/bang_olufsen.markdown +++ b/source/_integrations/bang_olufsen.markdown @@ -150,6 +150,43 @@ data: media_content_id: 1234567890 ``` +Playing a Tidal playlist. Optionally define starting position for the playlist: + +```yaml +service: media_player.play_media +target: + entity_id: media_player.beosound_balance_12345678 +data: + media_content_type: tidal + media_content_id: playlist:01234567-89ab-cdfe-0123-456789abcdef + extra: + start_from: 123 +``` + +Playing a Tidal album. Optionally define starting position for the album: + +```yaml +service: media_player.play_media +target: + entity_id: media_player.beosound_balance_12345678 +data: + media_content_type: tidal + media_content_id: album:123456789 + extra: + start_from: 123 +``` + +Playing a Tidal track: + +```yaml +service: media_player.play_media +target: + entity_id: media_player.beosound_balance_12345678 +data: + media_content_type: tidal + media_content_id: 123456789 +``` + ##### Overlay Interrupts currently playing media to play an audio message. @@ -159,10 +196,10 @@ Bang & Olufsen Cloud TTS messages are limited to 100 unique messages a day and a Extra keys available: -| Service data attribute | Optional | Description | -| ------------------------- | -------- | ------------------------------------------------------------------------------------------------ | -| `overlay_absolute_volume` | yes | Specify an absolute volume for the overlay. | -| `overlay_offset_volume` | yes | Specify a volume offset to be added to the current volume level. | +| Service data attribute | Optional | Description | +| ------------------------- | -------- | ------------------------------------------------------------------------------------------------- | +| `overlay_absolute_volume` | yes | Specify an absolute volume for the overlay. | +| `overlay_offset_volume` | yes | Specify a volume offset to be added to the current volume level. | | `overlay_tts_language` | yes | Specify the language used for text-to-speech. Uses the BCP 47 standard. Default value is "en-us". | ###### Examples: @@ -217,3 +254,6 @@ WebSocket notifications received from the device are fired as events in Home Ass To find Deezer playlist, album URIs, and user IDs for Deezer flows, the Deezer website has to be accessed. When navigating to an album, the URL will look something like: , and this needs to be converted to: `album:ALBUM_ID` and the same applies to playlists, which have the format: `playlist:PLAYLIST_ID`. Additionally a Deezer user ID can be found at by selecting the active user in a web browser. + +### Getting Tidal URIs +Tidal playlists, album URIs and track IDs are available via the Tidal website. When navigating to an album, the URL will look something like , and this needs to be converted to `album:ALBUM_ID`. The same applies to playlists, which have the format `playlist:PLAYLIST_ID`. Individual tracks can be found by sharing the track and selecting the `Copy track link` method, which should yield a link of the format , this can be played by extracting the track id `TRACK_ID`.