Geräteprofil · Multimedia

Volumio

Hinweis: Dieses Profil beruht auf der dokumentierten REST-Schnittstelle von Volumio.

Voraussetzungen

1. Ein Gerät mit Volumio 2 oder 3 (Raspberry Pi, Volumio Primo u. a.) im lokalen Netz.

2. Die Schnittstelle ist ohne weitere Einrichtung erreichbar. Prüfen im Browser:

   http://<IP-oder-volumio.local>/api/v1/getState
   

   Es muss ein JSON mit "status", "title" und "volume" zurückkommen.

Einrichtung

1. Dem Gerät 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 80 und lässt sich ändern (manche Installationen bedienen die Schnittstelle auf 3000)

Datenbereich

Abgefragt wird alle 10 Sekunden der vollständige Zustand (/api/v1/getState); das Intervall lässt sich ändern.

• Wiedergabe läuft (playing, zusätzlich als active): Status ist play
• Status (status): play, pause oder stop
• Titel (title), Interpret (artist), Album (album)
• Lautstärke (volume) 0–100 %, Stumm (mute)
• Shuffle, Repeat, Titellänge, Position, URI, Dateityp und Dienst (ausgeblendet)
• Erreichbarkeit (reachable): aus dem Erfolg der Abfragen

Schreibbar sind Wiedergabe (Play, Pause, Stop, Play/Pause, vor, zurück), Lautstärke samt lauter/leiser, Stumm ein/aus, Shuffle und Repeat.

Hinweise

• Werte werden beim Quellenwechsel geleert, nicht eingefroren. Bei einem Webradio liefert Volumio Interpret und Album als leere Felder mit, und nomos übernimmt sie. Der Sendername steht dann im Titel.
• Zahlen werden tolerant gelesen. Die Schlüsselreihenfolge in getState hat sich über die Volumio-Versionen geändert und ist nicht garantiert; das Profil liest jede Zahl bis zum Ende der Antwort und nimmt davon den vorderen Zahlenanteil. Dadurch ist es unempfindlich dagegen, ob nach einem Wert noch ein weiterer Schlüssel folgt oder nicht.
• Die Ja/Nein-Werte brauchen ihr Trennzeichen. mute, random und repeat werden am Komma begrenzt gelesen. Sollte eine Volumio-Version einen davon als letzten Schlüssel liefern, bleibt der alte Wert stehen. Bisher folgen in allen bekannten Fassungen weitere Schlüssel.
• Lautstärke: Ist in Volumio die Lautstärkeregelung abgeschaltet (disableVolumeControl), nimmt das Gerät Lautstärkebefehle nicht an. Das Profil zeigt das nicht eigens an.
• Eine Quittung wie {"response":"play Success"} enthält keine Werte und überschreibt deshalb nichts.
• Nicht im Profil enthalten: Durchsuchen und Abspielen der Bibliothek (browse, replaceAndPlay), Wiedergabelisten, Zonen/Multiroom, die Push-Schnittstelle über Socket.IO – nomos fragt stattdessen ab – und die Systembefehle (Neustart, Herunterfahren).