Sonos2mqtt: Unterschied zwischen den Versionen
(→SonosBridge aufrüsten: Codefehler im Setter beseitigt) |
TomLee (Diskussion | Beiträge) K (kleine Rechtschreibkorrekturen) |
||
(22 dazwischenliegende Versionen von 5 Benutzern werden nicht angezeigt) | |||
Zeile 7: | Zeile 7: | ||
== Tipps zur Verwendung == | == Tipps zur Verwendung == | ||
Die automatische Konfiguration setzt den alias entsprechend dem | Die automatische Konfiguration setzt den alias entsprechend dem im Sonos vergeben Namen . Die langen MQTT2_RINCON_ Namen sind unhandlich und schlecht lesbar. Man kann Player mit einem devspec ansprechen, das simpelste ist: | ||
:<code>set alias=Büro play</code> | |||
Oder alle Player | |||
:<code>set model=sonos2mqtt_speaker leaveGroup</code> | |||
== Konfiguration der Player == | |||
Mit dem Template sonos_bridge_comfort wird aus dem contrib Ordner eine Datei 99_sonos2mqttUtils.pm nachgeladen und aktiviert. Darin befindet sich der wesentliche Code, die sonos2mqtt Geräte selbst enthalten nur rudimentäre Aufrufe. | |||
Selbstverständlich kann man diese Datei jederzeit selbst gestalten (FHEM Menu:Edit Files) aber man sollte beachten, dass eine erneute Anwendung des Templates die Datei überschreibt. | |||
Man kann auch jederzeit diese Datei aus dem SVN neu laden: | |||
<syntaxhighlight lang="perl"> | |||
{ Svn_GetFile("contrib/AttrTemplate/99_sonos2mqttUtils.pm", "FHEM/99_sonos2mqttUtils.pm", sub(){ CommandReload(undef, "99_sonos2mqttUtils") }) } | |||
</syntaxhighlight>Hauptroutine ist sonos2mqtt die mit zwei Parametern aufgerufen wird. <code>{sonos2mqtt($NAME,$EVENT)}</code> | |||
Die Optik des Players wird mit der Routine <code>sonos2mqtt_devStateIcon</code> bestimmt. | |||
Man kann die Player mittels <code>attr a:model=sonos2mqtt_speaker webCmd volume</code> mit einem Slider in der Übersicht ausstatten. | |||
Ändert man die Sonoslandschaft, kann man auch alles einreißen und neu erzeugen lassen. Zunächst alles löschen (für die FHEM Kommandozeile):<syntaxhighlight lang="perl"> | |||
{fhem("delete a:model=sonos2mqtt_speaker;;delete FileLog_MQTT2_RINCON.*");;qx(rm ./log/MQTT2_RINCON_*);;return ""} | |||
</syntaxhighlight>Danach muss man sonos2mqtt einfach neu starten: pm2 start ... bzw den docker container neu starten. | |||
== Befehle nachrüsten == | == Befehle nachrüsten == | ||
Um Befehle | Um Befehle in der setList / getList / readingList nachzurüsten gibt es die Routine <code>sonos2mqtt_mod_list(devspec,attrName,line)</code> | ||
Vorhandene Zeilen werden ersetzt. Identifiziert wird nur der erste Teil bis zum ":". Beispiel für die Kommandozeile: | |||
<code>{sonos2mqtt_mod_list('a:model=sonos2mqtt_bridge','readingList','sonos/RINCON_([0-9A-Z]+)/Reply:.* Reply')}</code> | |||
{ | |||
} | |||
</ | |||
== | == Sprachausgabe == | ||
Man hat zwei Möglichkeiten, dies umzusetzen: | |||
# Text2Speech FHEM intern | |||
# Mit dem sonos text to speech Server https://svrooij.io/sonos2mqtt/ | |||
=== Text2Speech Variante einrichten === | |||
Zwei zusätzliche Geräte sind notwendig: | Zwei zusätzliche Geräte sind notwendig: | ||
* [[Text2Speech]] im Servermodus, erzeugt mp3 Dateien im cache Verzeichnis und legt einen Link im Reading httpName ab. | * [[Text2Speech]] im Servermodus, erzeugt mp3 Dateien im cache Verzeichnis und legt einen Link im Reading httpName ab. | ||
* Ein HTTP Server stellt die Dateien im gleichen Verzeichnis bereit | * Ein HTTP Server stellt die Dateien im gleichen Verzeichnis bereit | ||
'''Hinweis''': Für die vollständige Funktion und Installation von Text2Speech ist die Commandref zu beachten! Für das unten im Beispiel verwendete Feature UseMP3Wrap muss das Tool mp3wrap installiert werden (z.B. <code>apt install mp3wrap</code>). Dies ist bei längeren Texten und bei der Verwendung von eingebetteten festen Sounds existenziell! | |||
Für die Funktion ist wichtig, dass das Sonos System den Host im Link zur Datei richtig auflösen kann. Deshalb wird der Hostname und Port des Servers im Reading host des TTS Device als Name oder IP Adresse abgelegt! Dies kann entweder mit dem hier gezeigten Befehl oder vollständig manuell erfolgen. Für FHEM innerhalb Docker muss man die Adresse des Docker Host angeben. | |||
<syntaxhighlight lang="perl"> | |||
Für die Funktion ist wichtig, dass das Sonos System den Host im Link zur Datei richtig auflösen kann. Deshalb wird der Hostname und Port des Servers im Reading host des TTS Device als Name oder IP Adresse abgelegt! Dies kann entweder mit dem hier gezeigten Befehl oder vollständig manuell erfolgen.<syntaxhighlight lang="perl"> | |||
defmod SonosTTS Text2Speech none | defmod SonosTTS Text2Speech none | ||
attr SonosTTS TTS_UseMP3Wrap 1 | attr SonosTTS TTS_UseMP3Wrap 1 | ||
attr SonosTTS TTS_Language Deutsch | |||
attr SonosTTS userReadings httpName:lastFilename.* {'http://'.ReadingsVal($name,'host','set host:port first').'/fhem/'.ReadingsVal($name,'lastFilename','')} | attr SonosTTS userReadings httpName:lastFilename.* {'http://'.ReadingsVal($name,'host','set host:port first').'/fhem/'.ReadingsVal($name,'lastFilename','')} | ||
attr SonosTTS TTS_CacheFileDir cache | attr SonosTTS TTS_CacheFileDir cache | ||
setreading SonosTTS host {(qx(hostname -s|tr -d '\n').':'.InternalVal('WEB','PORT','8083'))} | setreading SonosTTS host {(qx(hostname -s|tr -d '\n').':'.InternalVal('WEB','PORT','8083'))} | ||
#setreading SonosTTS host {((split(' ', qx(hostname -I)))[0].':'.InternalVal('WEB','PORT','8083'))} | #setreading SonosTTS host {((split(' ', qx(hostname -I)))[0].':'.InternalVal('WEB','PORT','8083'))} | ||
#setreading SonosTTS host <hostname>:<port> | |||
defmod SonosSpeakWeb HTTPSRV cache cache SonosSpeakWeb | defmod SonosSpeakWeb HTTPSRV cache cache SonosSpeakWeb | ||
</syntaxhighlight>Durch den "sonos2mqtt notify" Befehl wird die laufende Umgebung wiederhergestellt. | </syntaxhighlight> | ||
* Wird der | Der Sprachausgabe Befehl im Player Device läuft in 3 Schritten: | ||
* Wird der | # mit dem TTS Gerät wird die mp3 Datei erzeugt, | ||
# mit dem sleep wird auf die Fertigstellung gewartet, | |||
# die Datei wird mit <code>set Player notify volume uri</code> abgespielt. | |||
</ | Durch den "sonos2mqtt notify" Befehl wird die laufende Umgebung wiederhergestellt. | ||
* Wird der Sprachbefehl an den Gruppenmaster gesendet wird die mp3 Datei in der gesamten Gruppe gespielt. | |||
* Wird der Sprachbefehl an ein Mitglied einer Gruppe gesendet (nicht den Master) wird die Gruppe aufgetrennt und später wieder hergestellt. | |||
Es sind zwei Befehle zur Sprachausgabe eingebaut: | |||
=== sayText Befehl === | |||
Dieser Befehl orientiert sich an den FHEM [[DevelopmentGuidelinesAV|DevelopmentGuidelines]] und sammelt "gleichzeitig" eintreffende Sprachnachrichten, damit nichts verloren geht. Informationen im Forum dazu in {{Link2Forum|Topic=111711|Message=1100112|LinkText=diesem Beitrag}}. | |||
Die Lautstärke wird separat in SonosTTS gesetzt: <code>setreading SonosTTS vol 15</code>, ebenso die Sprache (einmalig bei der Einrichtung oder bei Bedarf zwischendurch) <code>attr SonosTTS TTS_Language Deutsch</code> | |||
''Hinweis: Der Befehl <code>set SonosTTS volume xx</code> hat im Servermodus des Devices keine Wirkung!'' | |||
=== Speak Befehl === | |||
Dieser Befehl ist ähnlich wie der in der FHEM-Sonos Umgebung: | |||
:<code>set Player speak <volume> text</code> | |||
Verwendet man diesen Syntax (mit Sprache und Stimme am Anfang), wird automatisch der speak Befehl an die sonos-tts abgesetzt. Die sonos-tts muss man separat installieren/integrieren! | |||
<code>set EG.KU.Sonos speak de-DE Vicki 25 Test</code> | |||
Will man keine laufenden Sendung unterbrechen sondern einfach eine Ansage machen und danach etwas starten, kann man so vorgehen: | |||
<syntaxhighlight lang="perl"> | |||
set SonosTTS tts Hier steht die Ansage;sleep SonosTTS:playing:.0 ; set alias=PlayerAlias playUri [SonosTTS:httpName] | set SonosTTS tts Hier steht die Ansage;sleep SonosTTS:playing:.0 ; set alias=PlayerAlias playUri [SonosTTS:httpName] | ||
</syntaxhighlight> | </syntaxhighlight> | ||
=== | === Volume Befehl === | ||
Der Befehl akzeptiert einen zweiten Wert als Startwert d.h. set volume 25 10 setzt sofort auf 10 und startet dann fading auf 25. Ein zweiter Wert -1 erzeugt ein fading vom aktuellen Wert auf den angegebenen. | |||
==== Spiele feste Sounds ==== | |||
Generell kann man feste mp3 Dateien (Klingeltöne, Klänge usw.) auch im cache Verzeichnis ablegen und direkt mit dem Link starten. | |||
Es gibt zahlreiche Soundquellen im Internet, ist der gewünschte Sound dabei, kann man ihn innerhalb FHEM herunterladen und an Ort und Stelle platzieren. (Beispiel ohne und mit Umbennung) | |||
<syntaxhighlight lang="perl"> | |||
"wget -qP ./cache https://cdn.smartersoft-group.com/various/pull-bell-short.mp3" | |||
"wget -qO ./cache/KlingelTon.mp3 https://cdn.smartersoft-group.com/various/pull-bell-short.mp3" | |||
</syntaxhighlight> | </syntaxhighlight> | ||
Vergewissern ob der gewünschte Sound auch da ist: {qx(ls -lha ./cache)} | |||
=== | Mit set magic kann man dabei einfach Teile aus anderen Readings holen. | ||
<syntaxhighlight lang="perl"> | |||
set alias=Büro notify 25 {('http://[SonosTTS:host]/fhem/cache/KlingelTon.mp3')} | |||
</syntaxhighlight> | |||
Man kann auch den setter im Gerät erweitern <code>{sonos2mqtt_mod_list('a:model=sonos2mqtt_speaker','setList',q(playSound:textField ....))}</code> : | |||
<syntaxhighlight lang="perl"> | |||
playSound:textField {my $tts="SonosTTS";my ($cmd,$vol,$file)=split(' ', $EVENT,3);$file=($file=~m/.*\.mp3$/)?"$file":"$file.mp3";fhem("set $NAME notify $vol http://[$tts:host]/fhem/[a:$tts:TTS_CacheFileDir]/$file")} | |||
</syntaxhighlight> | |||
Damit sind dann dieser Syntax möglich: | |||
<syntaxhighlight lang="perl"> | |||
set alias=Büro playSound 40 KlingelTon.mp3 | |||
</syntaxhighlight> | |||
oder ohne Dateiendung (wird auf .mp3 gesetzt) | |||
<syntaxhighlight lang="perl"> | |||
set alias=Büro playSound 40 KlingelTon | |||
</syntaxhighlight> | |||
=== SonosBridge === | |||
Die SonsoBridge enthält bereits ein paar zentrale Funktionen und Readings, z.B. wird beim Laden der Favoritenliste ein Reading favlist und grouplist erzeugt, welches zur Erweiterung der Player mit Auswahllisten dienen kann. | |||
Man kann den playFav Befehl auch | === Player mit Favoritenliste und Gruppenliste ausstatten === | ||
Wenn nicht schon geschehen muss man jetzt die Favoriten zum ersten Mal einlesen: <syntaxhighlight lang="perl"> | |||
get SonosBridge Favorites | |||
</syntaxhighlight>Nachdem die SonosBridge "aufgerüstet" ist, kann man allen Playern die Favoritenliste zum Auswählen eintragen. Beide Zeile sind für die FHEM Kommandozeile und verwenden die Routine aus der 99_sonos2mqttUtils. | |||
<syntaxhighlight lang="perl"> | |||
{sonos2mqtt_mod_list('a:model=sonos2mqtt_speaker','setList','joinGroup:'.ReadingsVal((devspec2array('a:model=sonos2mqtt_bridge'))[0],'grouplist','').q( {sonos2mqtt($NAME,$EVENT)}))} | |||
{sonos2mqtt_mod_list('a:model=sonos2mqtt_speaker','setList','playFav:'.ReadingsVal((devspec2array('a:model=sonos2mqtt_bridge'))[0],'favlist','').q( {sonos2mqtt($NAME,$EVENT)}))} | |||
</syntaxhighlight> | |||
Man kann den playFav Befehl auch im set Befehl mit einem Teil des Favoriten Namen verwenden. Enthält die Favoritenliste z.B. Radio Leipzig würde der auch mit diesem Befehl angesteuert werden:<syntaxhighlight lang="perl"> | |||
set alias=Bad playFav leipzig | set alias=Bad playFav leipzig | ||
</syntaxhighlight> | </syntaxhighlight> | ||
=== Listen der Favoriten Radios und Playlist erstellen === | |||
Im Sonos System kann man an (mindestens) drei Stellen Favoriten hinterlegen: Sonos-Favoriten, Sonos-Playlisten, TuneIn: Meine Radiosender | |||
Diese drei Listen kann man einlesen und für die einfache Suche und Auswahl verwenden. Der play Befehl akzeptiert dazu zwei weitere Parameter und sucht in den entsprechenden Listen. | |||
Diese play Befehle starten nicht sofort, sondern erst nach einem folgenden set ... play. Damit kann man etwas vorbereiten und gezielt starten. | |||
<code>set alias=Büro play Favorite Deutschlandfunk</code> | |||
<code>set alias=Büro play Radio HitRadio</code> | |||
<code>set alias=Büro play Playlist Meine Hits</code> | |||
Die Sonos-Favoriten-, TuneIn: Meine Radiosender- und Sonos-Playlisten dazu vom Sonos System einmalig (bzw. bei Veränderungen) einlesen: | |||
<pre> | |||
get SonosBridge Reply Playlists;sleep SonosBridge:Reply.*;setreading SonosBridge Playlists [SonosBridge:Reply] | |||
get SonosBridge Reply Favorites;sleep SonosBridge:Reply.*;setreading SonosBridge Favorites [SonosBridge:Reply] | |||
get SonosBridge Reply Radios;sleep SonosBridge:Reply.*;setreading SonosBridge Radios [SonosBridge:Reply] | |||
</pre> | |||
Beispiel für ein Guten Morgen Radio: | |||
<pre> | |||
set alias=BadWanne,alias=Kueche joinGroup Bad; | |||
set alias=BadWanne,alias=Bad volume 13 6; | |||
set alias=Bad play Favorite Deutschlandfunk.Kultur.RP; | |||
set alias=Kueche volume 18 8; | |||
sleep 0.2;set alias=Bad play | |||
</pre> | |||
=== Radioliste durchtasten === | === Radioliste durchtasten === | ||
Will man eine Liste von bestimmten | Will man eine Liste von bestimmten Radiostationen mit einem Taster "durchtasten" kann man das wie folgt tun: | ||
Das oben erwähnte <code>99_sonos2mqttUtils.pm</code> (ab 6.1.2023) schreibt die Radios aus dem Reading <code>Favoriten</code> in das userReading <code>favlist</code> im SonosBridge Device und aktualisiert das auch. | |||
==== Der Befehl zum weiterschalten ==== | |||
Jedes Mal wenn dieser Befehl ausgeführt wird, wird der nächste "Radio-Favorit" (aus dem userReading <code>favlist</code> des SonosBridge Devices) gestartet. | |||
Erfolgt die Ausgabe eines Radiosender, wird bei einem <code>set ''sonos2mqtt_speaker'' next</code> auf den nächsten Sender in dieser Liste geschaltet und der <code>transportState</code> beibehalten. | |||
</ | |||
</ | |||
Will man vor dem Radiostart noch die Ansage des Senders haben, geht das zwar auch mit dem speak Befehl, die direkte Ausgabe ohne Restore der Umgebung (sonos2mqtt notify) ist aber effektiver. | ==== Name der Radiostation vor dem Umschalten ansagen ==== | ||
Will man vor dem Radiostart noch die Ansage des Senders haben, geht das zwar auch mit dem <code>speak</code> Befehl, die direkte Ausgabe ohne Restore der Umgebung (sonos2mqtt notify) ist aber effektiver. | |||
Damit das funktioniert müssen wir die Events einschränken: <syntaxhighlight lang="perl"> | Damit das funktioniert müssen wir die Events einschränken: | ||
<syntaxhighlight lang="perl"> | |||
attr model=sonos2mqtt_speaker event-on-change-reading .* | attr model=sonos2mqtt_speaker event-on-change-reading .* | ||
{my $dev = (devspec2array('model=sonos2mqtt_bridge'))[0];;my $r=Each($dev,ReadingsVal($dev,' | {my $dev = (devspec2array('model=sonos2mqtt_bridge'))[0];;my $r=Each($dev,ReadingsVal($dev,'favlist',''));;my $play = (devspec2array('alias=Büro'))[0];;my $tts="SonosTTS";;fhem("set $tts tts Es folgt $r;;sleep $tts:playing:.0;;set $play playUri [$tts:httpName];;sleep $play:play;;sleep $play:PLAYING;;sleep $play:STOPPED;;set $play playFav $r")} | ||
</syntaxhighlight>Kurze Erklärung zum Code | </syntaxhighlight> | ||
* ermittelt den nächsten Radiosender in der Liste, | Kurze Erklärung zum Code | ||
* erzeugt die Ansage "Es folgt SenderXY" | * ermittelt den nächsten Radiosender in der Liste: <code>my $dev = (devspec2array('model=sonos2mqtt_bridge'))[0];;my $r=Each($dev,ReadingsVal($dev,'favlist',<nowiki>''</nowiki>))</code> | ||
* wenn die mp3 Datei fertig erzeugt ist wird sie mit dem Befehl playUri an den | * ermitteln des Namens des <code>''sonos2mqtt_speaker''</code> Devices anhand des <code>alias</code> Attributes: <code>my $play = (devspec2array('alias=Büro'))[0]</code> | ||
* es wird eine Eventfolge abgewartet -> play / PLAYING / STOPPED | * erzeugt die Ansage "Es folgt SenderXY": <code>my $tts="SonosTTS";;fhem("set $tts tts Es folgt $r</code> | ||
* danach wird der Radiosender gestartet | * wenn die mp3 Datei fertig erzeugt ist: <code>sleep $tts:playing:.0</code>, wird sie mit dem Befehl playUri an den oben ermittelten <code>''sonos2mqtt_speaker''</code> gesendet: <code>set $play playUri [$tts:httpName]</code> | ||
Der Code ist so einfach und relativ "steif" für die Kommandozeile. Man | * es wird eine Eventfolge abgewartet -> play / PLAYING / STOPPED: <code>sleep $play:play;;sleep $play:PLAYING;;sleep $play:STOPPED</code> | ||
* danach wird der Radiosender gestartet: <code>set $play playFav $r</code> | |||
Der Code ist so einfach und relativ "steif" für die Kommandozeile. Man kann das auch in einen Setter packen (<code>set ''sonos2mqtt_speaker'' toggleRadio</code>). Dazu den Text unten in das Attribut <code>setList</code> des <code>''sonos2mqtt_speaker''</code> Devices hinzufügen: | |||
<syntaxhighlight lang="perl"> | |||
toggleRadio:noArg {my $dev = (devspec2array('model=sonos2mqtt_bridge'))[0];my $r=Each($dev,ReadingsVal($dev,'favlist',''));my $tts="SonosTTS";fhem("set $tts tts Es folgt $r;sleep $tts:playing:.0;set $NAME playUri [$tts:httpName];sleep $NAME:play;sleep $NAME:PLAYING;sleep $NAME:STOPPED;set $NAME playFav $r")} | |||
</syntaxhighlight> | |||
== Dokumentationen und weitere Entwicklungen == | == Dokumentationen und weitere Entwicklungen == | ||
ToDo | ToDo | ||
Erweiterung um Alarmhandling siehe [https://forum.fhem.de/index.php/topic,111711.msg1162031.html#msg1162031 Forum] | |||
[[Kategorie:MQTT]] |
Aktuelle Version vom 21. Dezember 2024, 15:02 Uhr
Grundeinrichtung
Die Grundeinrichtung ist bereits im Artikel MQTT2-Module - Praxisbeispiele beschrieben. Hier soll es um die praktische Verwendung und Erweiterung gehen.
Für alle Erweiterungen wird versucht vorhandene Devices in FHEM zu verwenden.
Viele Dinge werden derzeit noch entwickelt und können frei gestaltet werden - der Vorteil von generischen FHEM Devices.
Tipps zur Verwendung
Die automatische Konfiguration setzt den alias entsprechend dem im Sonos vergeben Namen . Die langen MQTT2_RINCON_ Namen sind unhandlich und schlecht lesbar. Man kann Player mit einem devspec ansprechen, das simpelste ist:
set alias=Büro play
Oder alle Player
set model=sonos2mqtt_speaker leaveGroup
Konfiguration der Player
Mit dem Template sonos_bridge_comfort wird aus dem contrib Ordner eine Datei 99_sonos2mqttUtils.pm nachgeladen und aktiviert. Darin befindet sich der wesentliche Code, die sonos2mqtt Geräte selbst enthalten nur rudimentäre Aufrufe.
Selbstverständlich kann man diese Datei jederzeit selbst gestalten (FHEM Menu:Edit Files) aber man sollte beachten, dass eine erneute Anwendung des Templates die Datei überschreibt.
Man kann auch jederzeit diese Datei aus dem SVN neu laden:
{ Svn_GetFile("contrib/AttrTemplate/99_sonos2mqttUtils.pm", "FHEM/99_sonos2mqttUtils.pm", sub(){ CommandReload(undef, "99_sonos2mqttUtils") }) }
Hauptroutine ist sonos2mqtt die mit zwei Parametern aufgerufen wird. {sonos2mqtt($NAME,$EVENT)}
Die Optik des Players wird mit der Routine sonos2mqtt_devStateIcon
bestimmt.
Man kann die Player mittels attr a:model=sonos2mqtt_speaker webCmd volume
mit einem Slider in der Übersicht ausstatten.
Ändert man die Sonoslandschaft, kann man auch alles einreißen und neu erzeugen lassen. Zunächst alles löschen (für die FHEM Kommandozeile):
{fhem("delete a:model=sonos2mqtt_speaker;;delete FileLog_MQTT2_RINCON.*");;qx(rm ./log/MQTT2_RINCON_*);;return ""}
Danach muss man sonos2mqtt einfach neu starten: pm2 start ... bzw den docker container neu starten.
Befehle nachrüsten
Um Befehle in der setList / getList / readingList nachzurüsten gibt es die Routine sonos2mqtt_mod_list(devspec,attrName,line)
Vorhandene Zeilen werden ersetzt. Identifiziert wird nur der erste Teil bis zum ":". Beispiel für die Kommandozeile:
{sonos2mqtt_mod_list('a:model=sonos2mqtt_bridge','readingList','sonos/RINCON_([0-9A-Z]+)/Reply:.* Reply')}
Sprachausgabe
Man hat zwei Möglichkeiten, dies umzusetzen:
- Text2Speech FHEM intern
- Mit dem sonos text to speech Server https://svrooij.io/sonos2mqtt/
Text2Speech Variante einrichten
Zwei zusätzliche Geräte sind notwendig:
- Text2Speech im Servermodus, erzeugt mp3 Dateien im cache Verzeichnis und legt einen Link im Reading httpName ab.
- Ein HTTP Server stellt die Dateien im gleichen Verzeichnis bereit
Hinweis: Für die vollständige Funktion und Installation von Text2Speech ist die Commandref zu beachten! Für das unten im Beispiel verwendete Feature UseMP3Wrap muss das Tool mp3wrap installiert werden (z.B. apt install mp3wrap
). Dies ist bei längeren Texten und bei der Verwendung von eingebetteten festen Sounds existenziell!
Für die Funktion ist wichtig, dass das Sonos System den Host im Link zur Datei richtig auflösen kann. Deshalb wird der Hostname und Port des Servers im Reading host des TTS Device als Name oder IP Adresse abgelegt! Dies kann entweder mit dem hier gezeigten Befehl oder vollständig manuell erfolgen. Für FHEM innerhalb Docker muss man die Adresse des Docker Host angeben.
defmod SonosTTS Text2Speech none
attr SonosTTS TTS_UseMP3Wrap 1
attr SonosTTS TTS_Language Deutsch
attr SonosTTS userReadings httpName:lastFilename.* {'http://'.ReadingsVal($name,'host','set host:port first').'/fhem/'.ReadingsVal($name,'lastFilename','')}
attr SonosTTS TTS_CacheFileDir cache
setreading SonosTTS host {(qx(hostname -s|tr -d '\n').':'.InternalVal('WEB','PORT','8083'))}
#setreading SonosTTS host {((split(' ', qx(hostname -I)))[0].':'.InternalVal('WEB','PORT','8083'))}
#setreading SonosTTS host <hostname>:<port>
defmod SonosSpeakWeb HTTPSRV cache cache SonosSpeakWeb
Der Sprachausgabe Befehl im Player Device läuft in 3 Schritten:
- mit dem TTS Gerät wird die mp3 Datei erzeugt,
- mit dem sleep wird auf die Fertigstellung gewartet,
- die Datei wird mit
set Player notify volume uri
abgespielt.
Durch den "sonos2mqtt notify" Befehl wird die laufende Umgebung wiederhergestellt.
- Wird der Sprachbefehl an den Gruppenmaster gesendet wird die mp3 Datei in der gesamten Gruppe gespielt.
- Wird der Sprachbefehl an ein Mitglied einer Gruppe gesendet (nicht den Master) wird die Gruppe aufgetrennt und später wieder hergestellt.
Es sind zwei Befehle zur Sprachausgabe eingebaut:
sayText Befehl
Dieser Befehl orientiert sich an den FHEM DevelopmentGuidelines und sammelt "gleichzeitig" eintreffende Sprachnachrichten, damit nichts verloren geht. Informationen im Forum dazu in diesem Beitrag.
Die Lautstärke wird separat in SonosTTS gesetzt: setreading SonosTTS vol 15
, ebenso die Sprache (einmalig bei der Einrichtung oder bei Bedarf zwischendurch) attr SonosTTS TTS_Language Deutsch
Hinweis: Der Befehl set SonosTTS volume xx
hat im Servermodus des Devices keine Wirkung!
Speak Befehl
Dieser Befehl ist ähnlich wie der in der FHEM-Sonos Umgebung:
set Player speak <volume> text
Verwendet man diesen Syntax (mit Sprache und Stimme am Anfang), wird automatisch der speak Befehl an die sonos-tts abgesetzt. Die sonos-tts muss man separat installieren/integrieren!
set EG.KU.Sonos speak de-DE Vicki 25 Test
Will man keine laufenden Sendung unterbrechen sondern einfach eine Ansage machen und danach etwas starten, kann man so vorgehen:
set SonosTTS tts Hier steht die Ansage;sleep SonosTTS:playing:.0 ; set alias=PlayerAlias playUri [SonosTTS:httpName]
Volume Befehl
Der Befehl akzeptiert einen zweiten Wert als Startwert d.h. set volume 25 10 setzt sofort auf 10 und startet dann fading auf 25. Ein zweiter Wert -1 erzeugt ein fading vom aktuellen Wert auf den angegebenen.
Spiele feste Sounds
Generell kann man feste mp3 Dateien (Klingeltöne, Klänge usw.) auch im cache Verzeichnis ablegen und direkt mit dem Link starten.
Es gibt zahlreiche Soundquellen im Internet, ist der gewünschte Sound dabei, kann man ihn innerhalb FHEM herunterladen und an Ort und Stelle platzieren. (Beispiel ohne und mit Umbennung)
"wget -qP ./cache https://cdn.smartersoft-group.com/various/pull-bell-short.mp3"
"wget -qO ./cache/KlingelTon.mp3 https://cdn.smartersoft-group.com/various/pull-bell-short.mp3"
Vergewissern ob der gewünschte Sound auch da ist: {qx(ls -lha ./cache)}
Mit set magic kann man dabei einfach Teile aus anderen Readings holen.
set alias=Büro notify 25 {('http://[SonosTTS:host]/fhem/cache/KlingelTon.mp3')}
Man kann auch den setter im Gerät erweitern {sonos2mqtt_mod_list('a:model=sonos2mqtt_speaker','setList',q(playSound:textField ....))}
:
playSound:textField {my $tts="SonosTTS";my ($cmd,$vol,$file)=split(' ', $EVENT,3);$file=($file=~m/.*\.mp3$/)?"$file":"$file.mp3";fhem("set $NAME notify $vol http://[$tts:host]/fhem/[a:$tts:TTS_CacheFileDir]/$file")}
Damit sind dann dieser Syntax möglich:
set alias=Büro playSound 40 KlingelTon.mp3
oder ohne Dateiendung (wird auf .mp3 gesetzt)
set alias=Büro playSound 40 KlingelTon
SonosBridge
Die SonsoBridge enthält bereits ein paar zentrale Funktionen und Readings, z.B. wird beim Laden der Favoritenliste ein Reading favlist und grouplist erzeugt, welches zur Erweiterung der Player mit Auswahllisten dienen kann.
Player mit Favoritenliste und Gruppenliste ausstatten
Wenn nicht schon geschehen muss man jetzt die Favoriten zum ersten Mal einlesen:
get SonosBridge Favorites
Nachdem die SonosBridge "aufgerüstet" ist, kann man allen Playern die Favoritenliste zum Auswählen eintragen. Beide Zeile sind für die FHEM Kommandozeile und verwenden die Routine aus der 99_sonos2mqttUtils.
{sonos2mqtt_mod_list('a:model=sonos2mqtt_speaker','setList','joinGroup:'.ReadingsVal((devspec2array('a:model=sonos2mqtt_bridge'))[0],'grouplist','').q( {sonos2mqtt($NAME,$EVENT)}))}
{sonos2mqtt_mod_list('a:model=sonos2mqtt_speaker','setList','playFav:'.ReadingsVal((devspec2array('a:model=sonos2mqtt_bridge'))[0],'favlist','').q( {sonos2mqtt($NAME,$EVENT)}))}
Man kann den playFav Befehl auch im set Befehl mit einem Teil des Favoriten Namen verwenden. Enthält die Favoritenliste z.B. Radio Leipzig würde der auch mit diesem Befehl angesteuert werden:
set alias=Bad playFav leipzig
Listen der Favoriten Radios und Playlist erstellen
Im Sonos System kann man an (mindestens) drei Stellen Favoriten hinterlegen: Sonos-Favoriten, Sonos-Playlisten, TuneIn: Meine Radiosender
Diese drei Listen kann man einlesen und für die einfache Suche und Auswahl verwenden. Der play Befehl akzeptiert dazu zwei weitere Parameter und sucht in den entsprechenden Listen.
Diese play Befehle starten nicht sofort, sondern erst nach einem folgenden set ... play. Damit kann man etwas vorbereiten und gezielt starten.
set alias=Büro play Favorite Deutschlandfunk
set alias=Büro play Radio HitRadio
set alias=Büro play Playlist Meine Hits
Die Sonos-Favoriten-, TuneIn: Meine Radiosender- und Sonos-Playlisten dazu vom Sonos System einmalig (bzw. bei Veränderungen) einlesen:
get SonosBridge Reply Playlists;sleep SonosBridge:Reply.*;setreading SonosBridge Playlists [SonosBridge:Reply] get SonosBridge Reply Favorites;sleep SonosBridge:Reply.*;setreading SonosBridge Favorites [SonosBridge:Reply] get SonosBridge Reply Radios;sleep SonosBridge:Reply.*;setreading SonosBridge Radios [SonosBridge:Reply]
Beispiel für ein Guten Morgen Radio:
set alias=BadWanne,alias=Kueche joinGroup Bad; set alias=BadWanne,alias=Bad volume 13 6; set alias=Bad play Favorite Deutschlandfunk.Kultur.RP; set alias=Kueche volume 18 8; sleep 0.2;set alias=Bad play
Radioliste durchtasten
Will man eine Liste von bestimmten Radiostationen mit einem Taster "durchtasten" kann man das wie folgt tun:
Das oben erwähnte 99_sonos2mqttUtils.pm
(ab 6.1.2023) schreibt die Radios aus dem Reading Favoriten
in das userReading favlist
im SonosBridge Device und aktualisiert das auch.
Der Befehl zum weiterschalten
Jedes Mal wenn dieser Befehl ausgeführt wird, wird der nächste "Radio-Favorit" (aus dem userReading favlist
des SonosBridge Devices) gestartet.
Erfolgt die Ausgabe eines Radiosender, wird bei einem set sonos2mqtt_speaker next
auf den nächsten Sender in dieser Liste geschaltet und der transportState
beibehalten.
Name der Radiostation vor dem Umschalten ansagen
Will man vor dem Radiostart noch die Ansage des Senders haben, geht das zwar auch mit dem speak
Befehl, die direkte Ausgabe ohne Restore der Umgebung (sonos2mqtt notify) ist aber effektiver.
Damit das funktioniert müssen wir die Events einschränken:
attr model=sonos2mqtt_speaker event-on-change-reading .*
{my $dev = (devspec2array('model=sonos2mqtt_bridge'))[0];;my $r=Each($dev,ReadingsVal($dev,'favlist',''));;my $play = (devspec2array('alias=Büro'))[0];;my $tts="SonosTTS";;fhem("set $tts tts Es folgt $r;;sleep $tts:playing:.0;;set $play playUri [$tts:httpName];;sleep $play:play;;sleep $play:PLAYING;;sleep $play:STOPPED;;set $play playFav $r")}
Kurze Erklärung zum Code
- ermittelt den nächsten Radiosender in der Liste:
my $dev = (devspec2array('model=sonos2mqtt_bridge'))[0];;my $r=Each($dev,ReadingsVal($dev,'favlist',''))
- ermitteln des Namens des
sonos2mqtt_speaker
Devices anhand desalias
Attributes:my $play = (devspec2array('alias=Büro'))[0]
- erzeugt die Ansage "Es folgt SenderXY":
my $tts="SonosTTS";;fhem("set $tts tts Es folgt $r
- wenn die mp3 Datei fertig erzeugt ist:
sleep $tts:playing:.0
, wird sie mit dem Befehl playUri an den oben ermitteltensonos2mqtt_speaker
gesendet:set $play playUri [$tts:httpName]
- es wird eine Eventfolge abgewartet -> play / PLAYING / STOPPED:
sleep $play:play;;sleep $play:PLAYING;;sleep $play:STOPPED
- danach wird der Radiosender gestartet:
set $play playFav $r
Der Code ist so einfach und relativ "steif" für die Kommandozeile. Man kann das auch in einen Setter packen (set sonos2mqtt_speaker toggleRadio
). Dazu den Text unten in das Attribut setList
des sonos2mqtt_speaker
Devices hinzufügen:
toggleRadio:noArg {my $dev = (devspec2array('model=sonos2mqtt_bridge'))[0];my $r=Each($dev,ReadingsVal($dev,'favlist',''));my $tts="SonosTTS";fhem("set $tts tts Es folgt $r;sleep $tts:playing:.0;set $NAME playUri [$tts:httpName];sleep $NAME:play;sleep $NAME:PLAYING;sleep $NAME:STOPPED;set $NAME playFav $r")}
Dokumentationen und weitere Entwicklungen
ToDo
Erweiterung um Alarmhandling siehe Forum