====== Playlisten / Radio / Dienste / lokale Dateien ====== Hier werden sämtliche Standardbefehle zur Steuerung von Radio Sendern und Playlisten gelistet. Diese müssen als virtueller Ausgangsbefehl (Loxone) oder in einem http Ausgang (Nicht Loxone) angelegt werden. ===== Syntax ===== Übersicht der gängigsten Befehle und auch erlaubte Kombinationen innerhalb einer Syntax. Wer die Funktionen erst im Browser testen möchte, setzt bitte jeweils folgendes vor die Syntax: | http:%%//%% oder | ===== Playlisten Befehle ===== | Funktion | Befehl / Syntax / URL | Einzel | Gruppe | Beschreibung | | sonosplaylist | /plugins/sonos4lox/index.php?zone=DEINE_ZONE&action=\\ **sonosplaylist&playlist=NAME_DER_PLAYLISTE&volume=15** | **X** | | Lädt die angegebene Playliste und startet die Wiedergabe mit Volume 15% | | load | /plugins/sonos4lox/index.php?zone=DEINE_ZONE&action=\\ **sonosplaylist&playlist=NAME_DER_PLAYLISTE&load** | **X** | **X** | Lädt die angegebene Playliste in die Queue **ohne** die Wiedergabe zu starten | | | /plugins/sonos4lox/index.php?zone=DEINE_ZONE&action=\\ **sonosplaylist&playlist=NAME_DER_PLAYLISTE&volume=25&member=ZONE2,ZONE3** | | **X** | Lädt die angegebene Playliste und startet die Wiedergabe auf 3 Playern parallel mit Volume 25% | | nextpush | /plugins/sonos4lox/index.php/?zone=DEINE_ZONE&action=**nextpush** | **X** | | Wenn PL läuft -> next track, Ende PL -> 1st track, Wenn Radio läuft -> nextradio im Loop, Wenn nichts läuft und die Queue leer ist -> nextradio im Loop | | zapzone | /plugins/sonos4lox/index.php/?zone=DEINE_ZONE&action=**zapzone** | **X** | | Im Falle das irgendein Player gerade etwas spielt wird die angegebene Zone als Member hinzugefügt, bei erneutem Betätigen wechselt die Zone zu einem evtl. zweiten spielenden Player oder die Funktion wechselt ab dann zu **nextradio** und zappt durch die Sender. Nach 60 Sekunden wird der ganze Vorgang resettet. | | playfavorite | /plugins/sonos4lox/index.php?zone=DEINE_ZONE&action=\\ **playfavorite&favorite=NAME_DES_FAVORITEN**&volume=25 | **X** | **X** | Lädt den angegebenen Favoriten und spielt ihn mit Volume 25 ab. Fuzzy Logic suche nach Keyword ist möglich | [[https://loxwiki.atlassian.net/wiki/pages/resumedraft.action?draftId=1228539439|Go to Top]] ===== Radio Befehle ===== Die verwendeten Radiosender müssen unter **Radio von TuneIn** → **Meine Radiosender** gespeichert sein und mit ihrem exakten Namen angegeben werden. | Funktion | Befehl / Syntax / URL | Einzel | Gruppe | Beschreibung | | radioplaylist | /plugins/sonos4lox/index.php?zone=DEINE_ZONE&action=**radioplaylist&playlist=NAME_DES SENDER&volume=15** | **X** | | Lädt den angegebenen Radio Sender und startet die Wiedergabe mit Volume 15% | | load | /plugins/sonos4lox/index.php?zone=DEINE_ZONE&action=**radioplaylist&playlist=NAME_DES SENDER&load** | **X** | **X** | Lädt den angegebenen Radio Sender **ohne** die Wiedergabe zu starten | | | /plugins/sonos4lox/index.php?zone=DEINE_ZONE&action=**radioplaylist&playlist=NAME_DES SENDER&volume=25&member=ZONE2** | | **X** | Lädt den angegebenen Radio Sender und startet die Wiedergabe auf 2 Playern mit Volume 25% | | randomradio | /plugins/sonos4lox/index.php/?zone=DEINE_ZONE&action=**randomradio** | **X** | | lädt einen zufällig gewählten Radiosender aus den **Radio von TuneIn** → **Meine Radiosender** aus und spielt ihn ab | | | /plugins/sonos4lox/index.php/?zone=DEINE_ZONE&action=**randomradio&except=1** | **X** | | Um Ausnahmen zu randomradio hinzuzufügen ist der o.g. Befehl im Browser einzugeben und dann basierend auf der Bildschirmausgabe die Sender zu selektieren die nicht inkludiert sein sollen. Als Kriterium gilt die Nummer der Array Bsp.\\ \\ **[1] => Array** dann eine 1 als except eingeben | | pluginradio | /plugins/sonos4lox/index.php/?zone=DEINE_ZONE&action=**pluginradio&radio=** | **X** | | Lädt den angegebenen Sender aus den Radio Favoriten des Sonos Plugins und spielt ihn ab | | | /plugins/sonos4lox/index.php/?zone=DEINE_ZONE&member=****&action=**pluginradio&radio=** | | **X** | | [[https://loxwiki.atlassian.net/wiki/pages/resumedraft.action?draftId=1228539439|Go to Top]] ===== ONE-Click Funktionen ===== ONE-Click Funktionen sind Befehle die in einer Endlosschlfeife bei jedem click etwas ausführen, je nach Befehl sind die ausgeführten Aktionen unterschiedlich. Diese ONE-click Funktionen bieten sich logischerweise für eine Tasterbedienung an. Für die folgenden Funktionen müssen die Radio Sender in der Plugin Konfiguration unter **Radio Favoriten** gepflegt sein | Funktion | Befehl / Syntax / URL | Einzel | Gruppe | Beschreibung | | nextradio | /plugins/sonos4lox/index.php/?zone=DEINE_ZONE&action=**nextradio** | **X** | | durchläuft die Liste der in Plugin Konfiguration hinterlegten "Radio Favoriten" sequentiell | | nextpush | /plugins/sonos4lox/index.php/?zone=DEINE_ZONE&action=**nextpush** | **X** | | Wenn eine Playliste/Album läuft -> next track. Wenn Radio läuft -> nextradio im Loop, Wenn nichts läuft und die Queue leer ist -> **nextradio** im Loop | | zapzone | /plugins/sonos4lox/index.php/?zone=DEINE_ZONE&action=**zapzone** | **X** | | Im Falle das irgendein Player gerade etwas spielt wird die angegebene Zone als Member hinzugefügt, bei erneutem Betätigen wechselt die Zone zu einem evtl. zweiten spielenden Player oder die Funktion wechselt ab dann zu **nextradio** und zappt durch die Sender. Nach 60 Sekunden wird der ganze Vorgang resettet. | **Folgende ONE-click Funktionen stehen mit der Version v4.1.4 zur Verfügung.** Mit diesem Release gibt es einige grundlegend neue ONE-Click Funktion was die Musiksteuerung anbelangt. ONE-Click insofern das bei jedem Aufruf bzw. Tastenklick der Funktionen der Befehl in einer Endlos Schleife ausgeführt wird (unterschiedlich je Befehl, siehe **Beschreibung** in unten stehender Tabelle). Die ONE-click Funktion kann je **Zone** und auch mit Member seperat genutzt werden. Das Looping wird durch andere Befehle resetet, ausgenommen durch folgende Befehle: ...action=**start, stop, play, pause, toggle, next, previous, volume, say, sendmessage, sendgroupmessage** Somit ist sichergestellt das die ONE-click Funktion (Looping) nicht unterbrochen wird. Durch Ausführen einer der anderen ONE-click Funktion für die gleiche Zone wird das Looping beendet. Für die genannten Funktionen stehen zusätzlich zum Sonos Standard auch Streaming Dienste zur Verfügung bzw. werden unterstützt. Einmal täglich werden die Funktionen durch einen Cronjob  resetet. Folgende Streaming Dienste werden derzeit unterstützt: * Apple Music * Amazon Music * Napster * Deezer * Sonos Radio * TuneIn Radio * Soundcloud * Mixcloud * YouTube Music * TIDAL Zusätzlich zu den Streaming Diensten werden die **Sonos Playlisten** und auch lokale Playlisten/Tracks der **Musikbibliothek** unterstützt | Funktion | Befehl / Syntax / URL | Einzel | Gruppe | Beschreibung / Taster | | playallfavorites | /plugins/sonos4lox/index.php/?zone=DEINE_ZONE&action=**playallfavorites** | **X** | **X** | lädt/spielt zuerst die Tracks aus den Sonos Favoriten, dann die Radiostationen\\ \\ **ONE-click → **bei Tracks: Next Track, wenn letzter Track erreicht, wird durch die Radiosender geloopt. Wenn letzter Radio Sender, dann Restart. **Playlisten/Alben** werden NICHT unterstützt | | playtrackfavorites | /plugins/sonos4lox/index.php/?zone=DEINE_ZONE&action=**playtrackfavorites** | **X** | **X** | lädt/spielt alle Tracks aus den Sonos Favoriten\\ \\ **ONE-click → **Next Track, wenn letzter Track dann Restart | | playradiofavorites | /plugins/sonos4lox/index.php/?zone=DEINE_ZONE&action=**playradiofavorites** | **X** | **X** | lädt/spielt alle Radio Stationen/Shows aus den Sonos Favoriten\\ \\ **ONE-click→** Nächster Radio Sender, wenn letzter Sender dann Restart | | playsonosplaylist | /plugins/sonos4lox/index.php/?zone=DEINE_ZONE&action=**playsonosplaylist** | **X** | **X** | lädt/spielt alle Sonos Playlisten\\ \\ **ONE-click→** Nächste Sonos Playliste, wenn letzte Playliste dann Restart\\ \\ Um durch die einzelnen Tracks zu clicken bietet sich eine Doppelklickbelegung des Tasters mit **...action=next** an | | playtuneinfavorites | /plugins/sonos4lox/index.php/?zone=DEINE_ZONE&action=**playtuneinfavorites** | **X** | **X** | lädt/spielt alle Radio Stationen/Shows von TuneIn "Meine Radiosender"\\ \\ **ONE-click→** Nächster Radio Sender, wenn letzter Sender dann Restart | | playplfavorites | /plugins/sonos4lox/index.php/?zone=DEINE_ZONE&action=**playplfavorites** | **X** | **X** | lädt/spielt alle Playlisten aus den Sonos Favoriten\\ \\ **ONE-click→** Nächste Playliste, wenn letzte Playliste dann Restart\\ \\ Um durch die einzelnen Tracks zu clicken bietet sich eine Doppelklickbelegung des Tasters mit **...action=next** an | ===== Dienstanbieter Funktionen ===== Möglichkeit des direkten Abspielens von Playlisten / Alben folgender Diensteanbieter: * Amazon * Apple * Napster * Spotify sowie lokaler Dateien die auf einer NAS, einem USB Stick, einem Laufwerk oder sonst wo liegen. Voraussetzung ist dass diese in der **Sonos Bibliothek** verfügbar sind. Für die Diensteanbieter wird die PL oder das Album über die jeweilige ID geladen. Um diese zu ermitteln musst du in die Anwendung (oder Browser) des Anbieters gehen, PL oder Album suchen und dir die ID ermitteln. Dies ist bei den Anbietern möglich über die Social Media links oder bei rechtsklick auf die Alben. Meistens steht dort "**Link kopieren**" oder "**Link für Facebook**" (oder Google, Instagram, etc.) und dann in irgendein Text Prog. kopieren. Die Links sehen dann wie folgt aus. Das fett rote ist dann die ID die für die Syntax kopiert werden muss: | Dienstanbieter | URL | | Amazon Album | **[[https://music.amazon.de/albums/B00IK3IV6Y|https:%%//%%music.amazon.de/albums/B00IK3IV6Y]]** | | Amazon Playlist | **[[https://music.amazon.de/playlists/B071W6HN35?ref=dm_wcp_pp_link_pb_pp_rec|https:%%//%%music.amazon.de/playlists/B071W6HN35?ref=dm_wcp_pp_link_pb_pp_rec]]** | | Amazon Track | **[[https://music.amazon.de/track/D00IK3IV6Y|https:%%//%%music.amazon.de/albums/B00IK3IV6Y]]** | | Spotify Playlist | **spotify:user:spotify:playlist:37i9dQZF1DX3h1vasAdBTc** | | Spotify Album | **spotify:album:0PNXB6AmSfM9oS0YwNkCYH** | | Napster Album | **[[https://app.napster.com/artist/art.4212/album/alb.285904254|https:%%//%%app.napster.com/artist/art.4212/album/alb.]][[https://app.napster.com/artist/art.4212/album/alb.285904254|285904254]]**\\ \\ **[[https://app.napster.com/artist/sia/album/everyday-is-christmas-287816565|https:%%//%%app.napster.com/artist/sia/album/everyday-is-christmas-287816565]]** | | Apple Music Album | **[[https://itunes.apple.com/de/album/eiskalt/1288630360|https:%%//%%itunes.apple.com/de/album/eiskalt/1288630360]]** | | Apple Music Playlist | **[[https://app.napster.com/playlist/pp.207466845| ]][[https://itunes.apple.com/de/playlist/angesagt-dance/pl.6bf4415b83ce4f3789614ac4c3675740|https:%%//%%itunes.apple.com/de/playlist/angesagt-dance/pl.6bf4415b83ce4f3789614ac4c3675740]]** | Wenn du die ID gefunden hast musst du diese nur noch in die Syntax kopieren und dann sollte die Playliste oder das Album geladen werden. Für den jeweiligen Anbieter einfach den **blauen** Teil austauschen (amazon, apple, napster, spotify). Bitte darauf achten das bei einem Album auch **albumuri** und bei Playlisten **playlisturi** in der Syntax verwendet wird.: | /plugins/sonos4lox/index.php?zone=DEINE_ZONE&action=amazon&**albumuri**=ID&volume=5 | | /plugins/sonos4lox/index.php/?zone=DEINE_ZONE&action=amazon&playlisturi=ID&volume=5 | Bei Spotify Playlisten könne auch User spezifische Playlisten genutzt werden, dafür muss aber zusätzlich der User Name in der Syntax angegeben werden. Hier ein Bsp. des Spotify links für die Playliste **Club Velcro (Revisited)** vom User **stevie-gfc**: **spotify:user:__stevie-gfc__:playlist:46V4B0kaRt7MHYCwt6BpmP** und hier die dazugehörige Syntax: | /plugins/sonos4lox/index.php/?zone=DEINE_ZONE&action=spotify&playlisturi=**46V4B0kaRt7MHYCwt6BpmP**&volume=5&user=__stevie-gfc__ | ===== Lokale Tracks ===== es können auch lokale Tracks aus deinem Netzwerk (NAS, Festplatte, USB Stick, etc.) abgespielt werden, hier gilt es aber zu beachten das diese in der Sonosbibliothek vorhanden sein sollten, ansonsten könnte es Freigabe Porblem geben. Außerdem muss IMMER der volle Pfad und auch die Dateiendung mitgegeben werden. Vom Format her werden Unix und Windows Angaben aktzeptiert und eine Prüfung auf unterstützte Formate ist integriert.\\ Folgende Audio Formate werden unterstützt:\\ [[https://sonos-de.custhelp.com/app/answers/detail/a_id/3661/~/unterst%C3%BCtzte-audioformate|unterstützte Audio Formate]]\\ __Hier einige Beispiele:__\\ Abspielen einer Datei von einem USB Stick oder Laufwerk E:\ an einem PC: | /plugins/sonos4lox/index.php/?zone=&action=track&file=%%//%%DESKTOP/E/05 Ich Und Ich - Vom Selben Stern.mp3 |  Abspielen einer Datei von einer NAS  | /plugins/sonos4lox/index.php/?zone=&action=track&file=\\SYN-DS415\music\Sonstige\DE_TOP100_01-2014\15 - Family Of The Year - Hero.mp3 | Abspielen einer Datei vom LoxBerry tts/mp3 Verzeichnis  | /plugins/sonos4lox/index.php/?zone=&action=track&file=%%//%%loxberry/sonos_tts/mp3/07 - Eminem - The Monster (feat. Rihanna).mp3 | Abspielen einer Datei vom LoxBerry Datenverzeichnis | /plugins/sonos4lox/index.php/?zone=&action=track&file=%%//%%LOXBERRY/loxberry/data/plugins/sonos4lox/tts/mp3/07 - Eminem - The Monster (feat. Rihanna).mp3 |  [[https://loxwiki.atlassian.net/wiki/pages/resumedraft.action?draftId=1228539439|Go to Top]]