From b5daf84e24e9e3dc35bc1b25fac2084a69172995 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Fr=C3=A9d=C3=A9ric=20Sagnes?= Date: Thu, 18 Jul 2024 03:54:28 +0100 Subject: [PATCH] Update Sonos Developer APIs (#52) * Update Sonos Developer APIs Clicking the Sonos Developer API links would send you to the login page then actually break because the links are obsolete, now it directs you to a public page so you can read about what the Sonos Cloud extension is about without thinking you need an account * Link to the integration creation page Getting to the integration creation page from the Sonos Developer portal is a pain, link directly to the integration page to make that easier --- README.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index 9e77ac3..066d149 100644 --- a/README.md +++ b/README.md @@ -2,7 +2,7 @@ [![hacs_badge](https://img.shields.io/badge/HACS-Default-41BDF5.svg)](https://github.com/hacs/integration) -The `sonos_cloud` integration uses the cloud-based [Sonos Control API](https://developer.sonos.com/reference/control-api/) to send [audioClip](https://developer.sonos.com/reference/control-api/audioclip/) commands to speakers. This allows playback of short clips (e.g., alert sounds, TTS messages) on Sonos speakers without interrupting playback. Audio played in this manner will reduce the volume of currently playing music, play the clip on top of the music, and then automatically return the music to its original volume. This is an alternative approach to the current method which requires taking snapshots & restoring speakers with complex scripts and automations. +The `sonos_cloud` integration uses the cloud-based [Sonos Control API](https://docs.sonos.com/docs/control) to send [audioClip](https://docs.sonos.com/reference/audioclip-loadaudioclip-playerid) commands to speakers. This allows playback of short clips (e.g., alert sounds, TTS messages) on Sonos speakers without interrupting playback. Audio played in this manner will reduce the volume of currently playing music, play the clip on top of the music, and then automatically return the music to its original volume. This is an alternative approach to the current method which requires taking snapshots & restoring speakers with complex scripts and automations. This API requires audio files to be in `.mp3` or `.wav` format and to have publicly accessible URLs. @@ -13,7 +13,7 @@ This API requires audio files to be in `.mp3` or `.wav` format and to have publi Both methods will require a restart of Home Assistant before you can configure the integration further. -You will need to create an account on the [Sonos Developer site](https://developer.sonos.com), and then create a new Control Integration. Provide a display name and description, provide a Key Name, and save the integration. It is not necessary to set a Redirect URI or callback URL. Save the Key and Secret values for the integration configuration. +You will need to create an account on the [Sonos Developer site](https://developer.sonos.com), and then [create a new Control Integration](https://integration.sonos.com/integrations). Provide a display name and description, provide a Key Name, and save the integration. It is not necessary to set a Redirect URI or callback URL. Save the Key and Secret values for the integration configuration. # Configuration
@@ -152,4 +152,4 @@ tts: ## Secure connections -Sonos devices have strict security requirements if served media over an SSL/TLS connection. See more details here: https://developer.sonos.com/build/content-service-get-started/security/. +Sonos devices have strict security requirements if served media over an SSL/TLS connection. [See more details here](https://docs.sonos.com/docs/security).