Geräteprofil · Multimedia

Bose SoundTouch

Hinweis: Dieses Profil beruht auf der Bose SoundTouch Web API (Version 1.1, Bose Corporation).

Voraussetzungen

1. Ein Bose SoundTouch-Lautsprecher (SoundTouch 10/20/30, Portable, Wave SoundTouch, SoundTouch 300, Lifestyle 550/600/650, SA-5 Amplifier) im lokalen Netz. Die lokale Schnittstelle hört auf Port 8090.
2. Kein Passwort und kein Token nötig – die Schnittstelle ist im lokalen Netz offen.
3. Ob Ihr Gerät das Tastenkommando unterstützt, zeigt http://<IP>:8090/supportedURLs im Browser; dort muss /key aufgeführt sein.
4. Ein nomos Controller mit einem Daemon, der die HTTP-Methode pro Befehl kennt (1.2.9 oder neuer). Ältere Daemons senden nur GET, damit lässt sich das Gerät ausschließlich lesen.

Einrichtung

1. Dem Lautsprecher im Router eine feste IP-Adresse geben
2. Skills → Add-ons: Profil importieren
3. Gerät anlegen und die IP-Adresse eintragen; der Port ist 8090

Datenbereich

Abgefragt werden alle 15 Sekunden die Wiedergabe (/now_playing) und die Lautstärke (/volume), alle 10 Minuten der Bass (/bass) und einmal pro Stunde die Geräteinfos (/info). Die ersten beiden Intervalle lassen sich ändern.

• Wiedergabe läuft (playing, zusätzlich als active): Abspielstatus ist PLAY_STATE
• Standby (standby): Quelle ist STANDBY
• Abspielstatus (status): PLAY_STATE, PAUSE_STATE, STOP_STATE, BUFFERING_STATE
• Titel (title), Interpret (artist), Album (album), Sender (station)
• Quelle (source): z. B. SPOTIFY, TUNEIN, BLUETOOTH, AUX, STANDBY
• Lautstärke (volume) 0–100 %, Stumm (mute)
• Name des laufenden Eintrags, Shuffle- und Repeat-Einstellung, Bass, Gerätename, Modell, Firmware und MAC-Adresse (ausgeblendet)
• Erreichbarkeit (reachable): aus dem Erfolg der HTTP-Abfragen

Schreibbar sind Lautstärke, die sechs Presets, Wiedergabe (Play, Pause, Play/Pause, Stop, vor, zurück), Ein/Aus und Stumm als Umschalter, Shuffle ein/aus, Repeat aus/einzeln/alle, Daumen hoch/runter, Favorit hinzufügen/entfernen und der Bass.

Hinweise

• nomos sendet nur den Tastendruck, nicht das Loslassen. Bose empfiehlt zwei Anfragen je Taste (state="press", dann state="release"), nennt es aber ausdrücklich „good practice” und nicht Pflicht. Ein Add-on-Befehl ist genau eine HTTP-Anfrage, deshalb geht nur der Druck hinaus. Presets sind dabei nicht in Gefahr: Gespeichert wird ein Preset über den eigenen Endpunkt /storePreset, nicht über langes Drücken.
• Ein/Aus und Stumm sind Umschalter. Die SoundTouch-Schnittstelle kennt nur die Tasten POWER und MUTE, keine getrennten Befehle für Ein und Aus. Deshalb hat das Gerät keinen Ein/Aus-Schalter mit Zustand, sondern eine Aktion „Ein/Aus (Umschalter)”. Ob der Lautsprecher aus ist, steht in standby.
• Werte werden beim Quellenwechsel geleert, nicht eingefroren: Läuft ein Radiostream, sind Titel, Interpret und Album leer; läuft ein Titel, ist der Sendername leer. Das Gerät liefert die leeren Elemente mit, und nomos übernimmt sie.
• Fehlt ein Element ganz, bleibt der letzte Wert stehen. Shuffle und Repeat liefert das Gerät nur bei Quellen, die das können – nach einem Wechsel auf Radio steht dort also noch die Einstellung der vorherigen Quelle.
• Der Bass-Bereich ist mit −9 bis 0 angenommen (der übliche Bereich). Den Bereich Ihres Modells nennt http://<IP>:8090/bassCapabilities. Weicht er ab, passt der Schieberegler nicht; das Gerät begrenzt den Wert selbst.
• Als Absender wird Gabbo geschickt, der von Bose dokumentierte Wert für eine Fernbedienung. Tastenname, Zustand und Absender sind bei Bose Groß-/Kleinschreibung-genau.
• Nicht im Profil enthalten: Auswahl einer Quelle oder eines Presets über /select (braucht das ContentItem des jeweiligen Geräts), Multiroom-Zonen (/setZone, /addZoneSlave), Presets speichern (/storePreset), Umbenennen (/name) und die Ereignis-Schnittstelle über WebSocket auf Port 8080 – nomos fragt stattdessen alle 15 Sekunden ab.