Übersicht SONOS (Cloud API)

Wichtig: Dieser Funktionsbaustein ist derzeit nur interne für Tests vorgesehen.

Mit diesem Funktionsbaustein können SONOS Lautsprecher über das offizielle SONOS Cloud Control API gesteuert werden. Er ist der Nachfolger des Bausteins „SONOS", der eine Fremdsoftware verwendet. Der alte Baustein bleibt bestehen; für neue Projekte wird dieser Baustein empfohlen.


Internet erforderlich: Die Steuerung läuft über die SONOS-Cloud. Die Steuerung und die Lautsprecher benötigen daher eine Internetverbindung. Es ist eine einmalige Anmeldung mit einem SONOS-Konto notwendig (siehe unten).

Anders als der alte Baustein liefert dieser Baustein auch Rückmeldungen (Wiedergabe, Lautstärke, Stumm je Zone) und beherrscht zusätzliche Funktionen wie Gruppieren (Partymodus), Abspielmodi (Zufall/Wiederholen/Überblenden) sowie das Abspielen einer Stream-URL oder des Line-In-Eingangs.

Sprachansage (Text to Speech): Das offizielle SONOS API bietet keine eigene Sprachausgabe. Für die Ansage wird — wie beim alten Baustein — ein externer Dienst verwendet, der derzeit noch kostenlos ist. Sollte sich das ändern, kann diese Funktion nicht garantiert werden. Als Alternative kann eine eigene Audiodatei über die Funktion „Audio-Clip" abgespielt werden.

Konfiguration: Zonen, Aktionen und Konto werden über den eigenen Dialog (Schaltfläche „SONOS konfigurieren" in den Parametern) bearbeitet. Die Einstellungen werden in der Steuerung gespeichert — der Dialog ist daher nur bei bestehender Verbindung zur Steuerung verfügbar.


Anmeldung (einmalig)
  1. Dialog „SONOS konfigurieren" öffnen (Steuerung muss verbunden sein).
  2. Im Bereich „Konto / Anmeldung" auf „SONOS-Anmeldeseite öffnen" klicken (oder „Login-Link kopieren" und im Browser öffnen).
  3. Mit dem SONOS-Konto anmelden. Nach der Anmeldung wird ein Code angezeigt.
  4. Diesen Code in das Feld „Authorization-Code" einfügen und den Dialog mit „Speichern" schließen.
  5. Die Steuerung tauscht den Code gegen ein dauerhaftes Zugangs-Token. Der Status wechselt auf „verbunden". Das Token überlebt einen Neustart der Steuerung — eine erneute Anmeldung ist nur bei „Abmelden" oder abgelaufenem Token nötig.

Eingänge
FG Freigabe Optionale Freigabe. Ist der Eingang nicht belegt, ist der Baustein automatisch freigegeben. Bei fehlender Freigabe werden keine Aktionen ausgelöst.

Ausgänge
ER Fehlercounter Zählt fehlgeschlagene Anfragen an die SONOS-Cloud (z. B. Netzwerkfehler, unbekannte Zone).
CN Verbunden 1 = Zugangs-Token gültig und letzte Statusabfrage erfolgreich, sonst 0.

Zonen-Adressen
Je aktiver Zone werden drei Adressen erzeugt. Sie werden zyklisch aus dem tatsächlichen Zustand der Lautsprecher aktualisiert (Rückmeldung) und können auch beschrieben werden (Steuerung):
Wiedergabe 1 = spielt, 0 = pausiert Schreiben: 1 startet die Wiedergabe, 0 pausiert.
Lautstärke 0 … 100 Schreiben setzt die Lautstärke der Zone.
Stumm 1 = stumm Schreiben schaltet die Zone stumm bzw. wieder laut.

Dialog: Zonen
Über „Zonen suchen" werden die im SONOS-Haushalt gefundenen Lautsprecher (Räume) geladen. Die Reihenfolge der Zonen bestimmt die erzeugten Adressen — vorhandene Zonen daher nicht umsortieren, sonst verschieben sich die Adressen. Der Name muss dem Raumnamen in der SONOS-App entsprechen.

Dialog: Aktionen
Eine Aktion löst bei einer Trigger-Adresse eine Funktion auf einer Zone aus. Die Trigger-Adresse wird per Drag&Drop aus dem Adressfenster in die Tabelle gezogen. Je Zeile werden Auslösung (Flanke/Telegramm), Zone, Funktion und funktionsabhängige Daten festgelegt.
Play / Pause / Play‑Pause — Wiedergabe starten, pausieren oder umschalten.
Stumm / Laut — Zone stumm schalten bzw. Ton wieder einschalten.
Nächster / Vorheriger Titel — Titelsprung (nicht bei allen Quellen möglich, z. B. Radio).
Lautstärke + / − Schrittweite 1 … 100 Lautstärke relativ erhöhen/senken.
Lautstärke = Wert Wert der Trigger-Adresse Setzt die Lautstärke auf den Wert, der auf der Trigger-Adresse anliegt (0 … 100).
Lautstärke absolut Wert 0 … 100 Setzt die Lautstärke auf den im Datenfeld angegebenen Wert.
Favorit Name des Favoriten Spielt einen SONOS-Favoriten ab. Über „Favoriten/Playlists laden" kann der Name aus einer Liste gewählt werden.
Playlist Name der Playlist Spielt eine SONOS-Playlist ab.
Sprachansage (TTS) Text/Sprache/Lautstärke Ansage über die laufende Musik, z. B. Mittagessen ist fertig/de/50. Nutzt einen externen Dienst (siehe Hinweis oben); begrenzte Textlänge.
Audio-Clip / Gong leer = Gong, sonst URL|Lautstärke Spielt einen Gong oder eine eigene Audiodatei (URL) über die laufende Musik ab. Beispiel: http://…/durchsage.mp3|60.
Zu Gruppe hinzufügen Name der Ziel-Zone Fügt die Zone der Gruppe der Ziel-Zone hinzu (z. B. Partymodus).
Aus Gruppe lösen — Trennt die Zone wieder aus ihrer Gruppe.
Zufall / Wiederholen / Überblenden 0 = aus, 1 = ein Setzt den Abspielmodus (Shuffle, Repeat, Crossfade).
Stream-URL abspielen Stream-URL Spielt eine Internetradio- oder Stream-URL ab.
Line-In — Schaltet auf den Line-In-Eingang des Lautsprechers um (sofern vorhanden).

Dialog: Konto
Abfrageintervall 5 … 3600 s Zeitabstand, in dem der Zustand der Zonen von der Cloud abgefragt wird (Standard 30 s). Kleinere Werte reagieren schneller, erzeugen aber mehr Anfragen.
Debug 0 / 1 Zusätzliche Meldungen im Trace der Steuerung zur Fehlersuche.
Abmelden — Löscht das gespeicherte Zugangs-Token. Danach ist eine erneute Anmeldung erforderlich.