mirror of
https://github.com/fhem/fhem-mirror.git
synced 2025-05-04 22:19:38 +00:00
Sonos: Add feature SONOSPLAYER_GetSlavePlayerNames()
git-svn-id: https://svn.fhem.de/fhem/trunk@7769 2b470e98-0d58-463d-a4d8-8e2adae1ed80
This commit is contained in:
rleins
parent
b0f092c587
commit
057bfc60ec
@ -47,6 +47,10 @@
|
||||
# Changelog
|
||||
#
|
||||
# SVN-History:
|
||||
# 30.01.2015
|
||||
# Commandref wurde optisch übersichtlicher gestaltet, und die Windows-Hinweise eingefügt.
|
||||
# Bei der Anzeige des nächsten Titels in der Standard-ReadingsGroup stand "Artist". Das wurde auf "Interpret" korrigiert.
|
||||
# Es gibt jetzt eine Prozedur "SONOSPLAYER_GetSlavePlayerNames()", mit der man sich die Teilnehmer einer Gruppe liefern lassen kann. Der Master wird nicht mit zurückgegeben. Man kann den Namen eines beliebigen Teilnehmers angeben.
|
||||
# 27.01.2015
|
||||
# Bei den Befehlen "AddMember", "RemoveMember" und "CreateStereoPair" werden nun alle in Fhem verfügbaren Sonosplayer in einer Auswahl angeboten. Das erfolgt allerdings ungeachtet der Gültigkeit eines Players in diesem Kontext (z.B. kann man keinen Player aus der Gruppe entfernen, der nicht in der Gruppe ist, die Auswahl bietet aber alle an).
|
||||
# Es gibt jetzt eine Prozedur "SONOSPLAYER_GetMasterPlayerName()" mit der man sich den Devicenamen des Masterplayer zu dem übergebenen Playernamen geben lassen kann.
|
||||
@ -659,7 +663,7 @@ sub SONOS_getTitleRG($;$) {
|
||||
# Läuft Radio oder ein "normaler" Titel
|
||||
if (ReadingsVal($device, 'currentNormalAudio', 1) == 1) {
|
||||
my $showNext = ReadingsVal($device, 'nextTitle', '') || ReadingsVal($device, 'nextArtist', '') || ReadingsVal($device, 'nextAlbum', '');
|
||||
$infoString = sprintf('<div style="margin-left: -150px;">%s Titel %s von %s<br />Titel: <b>%s</b><br />Interpret: <b>%s</b><br />Album: <b>%s</b>'.($showNext ? '<div style="height: %s;"></div>Nächste Wiedergabe:</div><div style="float: left; margin-left: 0px;"><img style="margin: 0px; padding: 0px; margin-right: 5px; border: 1px solid lightgray; height: 3.5em;" border="0" src="%s" /></div><div style="margin-left: 0px;">Titel: %s<br />Artist: %s<br />Album: %s</div>' : ''),
|
||||
$infoString = sprintf('<div style="margin-left: -150px;">%s Titel %s von %s<br />Titel: <b>%s</b><br />Interpret: <b>%s</b><br />Album: <b>%s</b>'.($showNext ? '<div style="height: %s;"></div>Nächste Wiedergabe:</div><div style="float: left; margin-left: 0px;"><img style="margin: 0px; padding: 0px; margin-right: 5px; border: 1px solid lightgray; height: 3.5em;" border="0" src="%s" /></div><div style="margin-left: 0px;">Titel: %s<br />Interpret: %s<br />Album: %s</div>' : ''),
|
||||
$transportState,
|
||||
ReadingsVal($device, 'currentTrack', ''),
|
||||
ReadingsVal($device, 'numberOfTracks', ''),
|
||||
@ -6932,57 +6936,61 @@ sub SONOS_Client_IsAlive() {
|
||||
<li><code>HTTP::Request</code></li></ul>
|
||||
Installation e.g. as Debian-Packages (via "sudo apt-get install <packagename>"):<ul>
|
||||
<li>LWP::Simple-Packagename (incl. LWP::UserAgent and HTTP::Request): libwww-perl</li>
|
||||
<li>SOAP::Lite-Packagename: libsoap-lite-perl</li></ul></p>
|
||||
<li>SOAP::Lite-Packagename: libsoap-lite-perl</li></ul>
|
||||
<br />Installation e.g. as Windows ActivePerl (via Perl-Packagemanager)<ul>
|
||||
<li>Install Package LWP (incl. LWP::UserAgent and HTTP::Request)</li>
|
||||
<li>Install Package SOAP::Lite</li>
|
||||
<li>SOAP::Lite-Special for Versions after 5.18:<ul>
|
||||
<li>Add another Packagesource from suggestions or manual: Bribes de Perl (http://www.bribes.org/perl/ppm)</li>
|
||||
<li>Install Package: SOAP::Lite</li></ul></li></ul>
|
||||
<b>Windows ActivePerl 64Bit is currently not functioning due to missing SOAP::Lite</b></p>
|
||||
<p><b>Attention!</b><br />This Module will not be functioning on any platform, because of the use of Threads and the neccessary Perl-modules.</p>
|
||||
<p>More information is given in a (german) Wiki-article: <a href="http://www.fhemwiki.de/wiki/SONOS">http://www.fhemwiki.de/wiki/SONOS</a></p>
|
||||
<p>The system consists of two different components:<br />
|
||||
1. A UPnP-Client which runs as a standalone process in the background and takes the communications to the sonos-components.<br />
|
||||
2. The FHEM-module itself which connects to the UPnP-client to make fhem able to work with sonos.<br /><br />
|
||||
The client will be startet by the module itself if not done in another way.<br />
|
||||
The client will be started by the module itself if not done in another way.<br />
|
||||
You can start this client on your own (to let it run instantly and independent from FHEM):<br />
|
||||
<code>perl 00_SONOS.pm 4711</code>: Starts a UPnP-Client in an independant way who listens to connections on port 4711. This process can run a long time, FHEM can connect and disconnect to it.</p>
|
||||
<h4>Example</h4>
|
||||
<p>
|
||||
<code>define Sonos SONOS localhost:4711 30</code>
|
||||
</p>
|
||||
<br />
|
||||
<a name="SONOSdefine"></a>
|
||||
<h4>Define</h4>
|
||||
<code>define <name> SONOS [upnplistener [interval [waittime [delaytime]]]]</code>
|
||||
<b><code>define <name> SONOS [upnplistener [interval [waittime [delaytime]]]]</code></b>
|
||||
<br /><br /> Define a Sonos interface to communicate with a Sonos-System.<br />
|
||||
<p>
|
||||
<code>[upnplistener]</code><br />The name and port of the external upnp-listener. If not given, defaults to <code>localhost:4711</code>. The port has to be a free portnumber on your system. If you don't start a server on your own, the script does itself.<br />If you start it yourself write down the correct informations to connect.</p>
|
||||
<b><code>[upnplistener]</code></b><br />The name and port of the external upnp-listener. If not given, defaults to <code>localhost:4711</code>. The port has to be a free portnumber on your system. If you don't start a server on your own, the script does itself.<br />If you start it yourself write down the correct informations to connect.</p>
|
||||
<p>
|
||||
<code>[interval]</code><br /> The interval is for alive-checking of Zoneplayer-device, because no message come if the host disappear :-)<br />If omitted a value of 10 seconds is the default.</p>
|
||||
<b><code>[interval]</code></b><br /> The interval is for alive-checking of Zoneplayer-device, because no message come if the host disappear :-)<br />If omitted a value of 10 seconds is the default.</p>
|
||||
<p>
|
||||
<code>[waittime]</code><br /> With this value you can configure the waiting time for the starting of the Subprocess.</p>
|
||||
<b><code>[waittime]</code></b><br /> With this value you can configure the waiting time for the starting of the Subprocess.</p>
|
||||
<p>
|
||||
<code>[delaytime]</code><br /> With this value you can configure a delay time before starting the network-part.</p>
|
||||
<br />
|
||||
<br />
|
||||
<b><code>[delaytime]</code></b><br /> With this value you can configure a delay time before starting the network-part.</p>
|
||||
<a name="SONOSset"></a>
|
||||
<h4>Set</h4>
|
||||
<ul>
|
||||
<li><b>Control-Commands</b><ul>
|
||||
<li><a name="SONOS_setter_Mute">
|
||||
<code>set <name> Mute <state></code></a>
|
||||
<b><code>Mute <state></code></b></a>
|
||||
<br />Sets the mute-state on all players.</li>
|
||||
<li><a name="SONOS_setter_PauseAll">
|
||||
<code>set <name> PauseAll</code></a>
|
||||
<b><code>PauseAll</code></b></a>
|
||||
<br />Pause all Zoneplayer.</li>
|
||||
<li><a name="SONOS_setter_Pause">
|
||||
<code>set <name> Pause</code></a>
|
||||
<b><code>Pause</code></b></a>
|
||||
<br />Alias for PauseAll.</li>
|
||||
<li><a name="SONOS_setter_StopAll">
|
||||
<code>set <name> StopAll</code></a>
|
||||
<b><code>StopAll</code></b></a>
|
||||
<br />Stops all Zoneplayer.</li>
|
||||
<li><a name="SONOS_setter_Stop">
|
||||
<code>set <name> Stop</code></a>
|
||||
<b><code>Stop</code></b></a>
|
||||
<br />Alias for StopAll.</li>
|
||||
</ul></li>
|
||||
<li><b>Group-Commands</b><ul>
|
||||
<li><a name="SONOS_setter_Groups">
|
||||
<code>set <name> Groups <GroupDefinition></code></a>
|
||||
<b><code>Groups <GroupDefinition></code></b></a>
|
||||
<br />Sets the current groups on the whole Sonos-System. The format is the same as retreived by getter 'Groups'.</li>
|
||||
</ul></li>
|
||||
</ul>
|
||||
@ -6992,7 +7000,7 @@ You can start this client on your own (to let it run instantly and independent f
|
||||
<ul>
|
||||
<li><b>Group-Commands</b><ul>
|
||||
<li><a name="SONOS_getter_Groups">
|
||||
<code>get <name> Groups</code></a>
|
||||
<b><code>Groups</code></b></a>
|
||||
<br />Retreives the current group-configuration of the Sonos-System. The format is a comma-separated List of Lists with devicenames e.g. <code>[Sonos_Kueche], [Sonos_Wohnzimmer, Sonos_Schlafzimmer]</code>. In this example there are two groups: the first consists of one player and the second consists of two players.<br />
|
||||
The order in the sublists are important, because the first entry defines the so-called group-coordinator (in this case <code>Sonos_Wohnzimmer</code>), from which the current playlist and the current title playing transferred to the other member(s).</li>
|
||||
</ul></li>
|
||||
@ -7003,47 +7011,47 @@ The order in the sublists are important, because the first entry defines the so-
|
||||
'''Attention'''<br />The most of the attributes can only be used after a restart of fhem, because it must be initially transfered to the subprocess.
|
||||
<ul>
|
||||
<li><b>Common</b><ul>
|
||||
<li><a name="SONOS_attribut_characterDecoding"><code>attr <name> characterDecoding <codingname></code>
|
||||
<li><a name="SONOS_attribut_characterDecoding"><b><code>characterDecoding <codingname></code></b>
|
||||
</a><br />With this attribute you can define a character-decoding-class. E.g. <UTF-8>. Default is <CP-1252>.</li>
|
||||
<li><a name="SONOS_attribut_disable"><code>attr <name> disable <value></code>
|
||||
</a><br />One of (0,1). With this value you can disable the whole module. Works immediatly. If set to 1 the subprocess will be terminated and no message will be transmitted. If set to 0 the subprocess is again startet.<br />It is useful when you install new Sonos-Components and don't want any disgusting devices during the Sonos setup.</li>
|
||||
<li><a name="SONOS_attribut_pingType"><code>attr <name> pingType <string></code>
|
||||
<li><a name="SONOS_attribut_disable"><b><code>disable <value></code></b>
|
||||
</a><br />One of (0,1). With this value you can disable the whole module. Works immediatly. If set to 1 the subprocess will be terminated and no message will be transmitted. If set to 0 the subprocess is again started.<br />It is useful when you install new Sonos-Components and don't want any disgusting devices during the Sonos setup.</li>
|
||||
<li><a name="SONOS_attribut_pingType"><b><code>pingType <string></code></b>
|
||||
</a><br /> One of (none,tcp,udp,icmp,syn). Defines which pingType for alive-Checking has to be used. If set to 'none' no checks will be done.</li>
|
||||
</ul></li>
|
||||
<li><b>Proxy Configuration</b><ul>
|
||||
<li><a name="SONOS_attribut_generateProxyAlbumArtURLs"><code>attr <name> generateProxyAlbumArtURLs <int></code>
|
||||
<li><a name="SONOS_attribut_generateProxyAlbumArtURLs"><b><code>generateProxyAlbumArtURLs <int></code></b>
|
||||
</a><br />One of (0, 1). If defined, all Cover-Links (the readings "currentAlbumArtURL" and "nextAlbumArtURL") are generated as links to the internal Sonos-Module-Proxy. It can be useful if you access Fhem over an external proxy and therefore have no access to the local network (the URLs are direct URLs to the Sonosplayer instead).</li>
|
||||
<li><a name="SONOS_attribut_proxyCacheDir"><code>attr <name> proxyCacheDir <Path></code>
|
||||
<li><a name="SONOS_attribut_proxyCacheDir"><b><code>proxyCacheDir <Path></code></b>
|
||||
</a><br />Defines a directory where the cached Coverfiles can be placed. If not defined "/tmp" will be used.</li>
|
||||
<li><a name="SONOS_attribut_proxyCacheTime"><code>attr <name> proxyCacheTime <int></code>
|
||||
<li><a name="SONOS_attribut_proxyCacheTime"><b><code>proxyCacheTime <int></code></b>
|
||||
</a><br />A time in seconds. With a definition other than "0" the caching mechanism of the internal Sonos-Module-Proxy will be activated. If the filetime of the chached cover is older than this time, it will be reloaded from the Sonosplayer.</li>
|
||||
</ul></li>
|
||||
<li><b>Speak Configuration</b><ul>
|
||||
<li><a name="SONOS_attribut_targetSpeakDir"><code>attr <name> targetSpeakDir <string></code>
|
||||
<li><a name="SONOS_attribut_targetSpeakDir"><b><code>targetSpeakDir <string></code></b>
|
||||
</a><br /> Defines, which Directory has to be used for the Speakfiles</li>
|
||||
<li><a name="SONOS_attribut_targetSpeakURL"><code>attr <name> targetSpeakURL <string></code>
|
||||
<li><a name="SONOS_attribut_targetSpeakURL"><b><code>targetSpeakURL <string></code></b>
|
||||
</a><br /> Defines, which URL has to be used for accessing former stored Speakfiles as seen from the SonosPlayer</li>
|
||||
<li><a name="SONOS_attribut_targetSpeakFileTimestamp"><code>attr <name> targetSpeakFileTimestamp <int></code>
|
||||
<li><a name="SONOS_attribut_targetSpeakFileTimestamp"><b><code>targetSpeakFileTimestamp <int></code></b>
|
||||
</a><br /> One of (0, 1). Defines, if the Speakfile should have a timestamp in his name. That makes it possible to store all historical Speakfiles.</li>
|
||||
<li><a name="SONOS_attribut_targetSpeakFileHashCache"><code>attr <name> targetSpeakFileHashCache <int></code>
|
||||
<li><a name="SONOS_attribut_targetSpeakFileHashCache"><b><code>targetSpeakFileHashCache <int></code></b>
|
||||
</a><br /> One of (0, 1). Defines, if the Speakfile should have a hash-value in his name. If this value is set to one an already generated file with the same hash is re-used and not newly generated.</li>
|
||||
<li><a name="SONOS_attribut_Speak1"><code>attr <name> Speak1 <Fileextension>:<Commandline></code>
|
||||
<li><a name="SONOS_attribut_Speak1"><b><code>Speak1 <Fileextension>:<Commandline></code></b>
|
||||
</a><br />Defines a systemcall commandline for generating a speaking file out of the given text. If such an attribute is defined, an associated setter at the Sonosplayer-Device is available. The following placeholders are available:<br />'''%language%''': Will be replaced by the given language-parameter<br />'''%filename%''': Will be replaced by the complete target-filename (incl. fileextension).<br />'''%text%''': Will be replaced with the given text</li>
|
||||
<li><a name="SONOS_attribut_Speak2"><code>attr <name> Speak2 <Fileextension>:<Commandline></code>
|
||||
<li><a name="SONOS_attribut_Speak2"><b><code>Speak2 <Fileextension>:<Commandline></code></b>
|
||||
</a><br />See Speak1</li>
|
||||
<li><a name="SONOS_attribut_Speak3"><code>attr <name> Speak3 <Fileextension>:<Commandline></code>
|
||||
<li><a name="SONOS_attribut_Speak3"><b><code>Speak3 <Fileextension>:<Commandline></code></b>
|
||||
</a><br />See Speak1</li>
|
||||
<li><a name="SONOS_attribut_Speak4"><code>attr <name> Speak4 <Fileextension>:<Commandline></code>
|
||||
<li><a name="SONOS_attribut_Speak4"><b><code>Speak4 <Fileextension>:<Commandline></code></b>
|
||||
</a><br />See Speak1</li>
|
||||
<li><a name="SONOS_attribut_SpeakCover"><code>attr <name> SpeakCover <Filename></code>
|
||||
<li><a name="SONOS_attribut_SpeakCover"><b><code>SpeakCover <Filename></code></b>
|
||||
</a><br />Defines a Cover for use by the speak generation process. If not defined the Fhem-logo will be used.</li>
|
||||
<li><a name="SONOS_attribut_Speak1Cover"><code>attr <name> Speak1Cover <Filename></code>
|
||||
<li><a name="SONOS_attribut_Speak1Cover"><b><code>Speak1Cover <Filename></code></b>
|
||||
</a><br />See SpeakCover</li>
|
||||
<li><a name="SONOS_attribut_Speak2Cover"><code>attr <name> Speak2Cover <Filename></code>
|
||||
<li><a name="SONOS_attribut_Speak2Cover"><b><code>Speak2Cover <Filename></code></b>
|
||||
</a><br />See SpeakCover</li>
|
||||
<li><a name="SONOS_attribut_Speak3Cover"><code>attr <name> Speak3Cover <Filename></code>
|
||||
<li><a name="SONOS_attribut_Speak3Cover"><b><code>Speak3Cover <Filename></code></b>
|
||||
</a><br />See SpeakCover</li>
|
||||
<li><a name="SONOS_attribut_Speak4Cover"><code>attr <name> Speak4Cover <Filename></code>
|
||||
<li><a name="SONOS_attribut_Speak4Cover"><b><code>Speak4Cover <Filename></code></b>
|
||||
</a><br />See SpeakCover</li>
|
||||
</ul></li>
|
||||
</ul>
|
||||
@ -7063,7 +7071,14 @@ The order in the sublists are important, because the first entry defines the so-
|
||||
<li><code>HTTP::Request</code></li></ul>
|
||||
Installation z.B. als Debian-Pakete (mittels "sudo apt-get install <packagename>"):<ul>
|
||||
<li>LWP::Simple-Packagename (inkl. LWP::UserAgent und HTTP::Request): libwww-perl</li>
|
||||
<li>SOAP::Lite-Packagename: libsoap-lite-perl</li></ul></p>
|
||||
<li>SOAP::Lite-Packagename: libsoap-lite-perl</li></ul>
|
||||
<br />Installation z.B. als Windows ActivePerl (mittels Perl-Packagemanager)<ul>
|
||||
<li>Package LWP (incl. LWP::UserAgent and HTTP::Request)</li>
|
||||
<li>Package SOAP::Lite</li>
|
||||
<li>SOAP::Lite-Special für Versionen nach 5.18:<ul>
|
||||
<li>Eine andere Paketquelle von den Vorschlägen oder manuell hinzufügen: Bribes de Perl (http://www.bribes.org/perl/ppm)</li>
|
||||
<li>Package: SOAP::Lite</li></ul></li></ul>
|
||||
<b>Windows ActivePerl 64Bit kann momentan nicht verwendet werden, da es das Paket SOAP::Lite dort momentan nicht gibt.</b></p>
|
||||
<p><b>Achtung!</b><br />Das Modul wird nicht auf jeder Plattform lauffähig sein, da Threads und die angegebenen Perl-Module verwendet werden.</p>
|
||||
<p>Mehr Informationen im (deutschen) Wiki-Artikel: <a href="http://www.fhemwiki.de/wiki/SONOS">http://www.fhemwiki.de/wiki/SONOS</a></p>
|
||||
<p>Das System besteht aus zwei Komponenten:<br />
|
||||
@ -7076,44 +7091,41 @@ Man kann den Server unabhängig von FHEM selbst starten (um ihn dauerhaft und un
|
||||
<p>
|
||||
<code>define Sonos SONOS localhost:4711 30</code>
|
||||
</p>
|
||||
<br />
|
||||
<a name="SONOSdefine"></a>
|
||||
<h4>Definition</h4>
|
||||
<code>define <name> SONOS [upnplistener [interval [waittime [delaytime]]]]</code>
|
||||
<b><code>define <name> SONOS [upnplistener [interval [waittime [delaytime]]]]</code></b>
|
||||
<br /><br /> Definiert das Sonos interface für die Kommunikation mit dem Sonos-System.<br />
|
||||
<p>
|
||||
<code>[upnplistener]</code><br />Name und Port eines externen UPnP-Client. Wenn nicht angegebenen wird <code>localhost:4711</code> festgelegt. Der Port muss eine freie Portnummer ihres Systems sein. <br />Wenn sie keinen externen Client gestartet haben, startet das Skript einen eigenen.<br />Wenn sie einen eigenen Dienst gestartet haben, dann geben sie hier die entsprechenden Informationen an.</p>
|
||||
<b><code>[upnplistener]</code></b><br />Name und Port eines externen UPnP-Client. Wenn nicht angegebenen wird <code>localhost:4711</code> festgelegt. Der Port muss eine freie Portnummer ihres Systems sein. <br />Wenn sie keinen externen Client gestartet haben, startet das Skript einen eigenen.<br />Wenn sie einen eigenen Dienst gestartet haben, dann geben sie hier die entsprechenden Informationen an.</p>
|
||||
<p>
|
||||
<code>[interval]</code><br /> Das Interval wird für die Überprüfung eines Zoneplayers benötigt. In diesem Interval wird nachgeschaut, ob der Player noch erreichbar ist, da sich ein Player nicht mehr abmeldet, wenn er abgeschaltet wird :-)<br />Wenn nicht angegeben, wird ein Wert von 10 Sekunden angenommen.</p>
|
||||
<b><code>[interval]</code></b><br /> Das Interval wird für die Überprüfung eines Zoneplayers benötigt. In diesem Interval wird nachgeschaut, ob der Player noch erreichbar ist, da sich ein Player nicht mehr abmeldet, wenn er abgeschaltet wird :-)<br />Wenn nicht angegeben, wird ein Wert von 10 Sekunden angenommen.</p>
|
||||
<p>
|
||||
<code>[waittime]</code><br /> Hiermit wird die Wartezeit eingestellt, die nach dem Starten des SubProzesses darauf gewartet wird.</p>
|
||||
<b><code>[waittime]</code></b><br /> Hiermit wird die Wartezeit eingestellt, die nach dem Starten des SubProzesses darauf gewartet wird.</p>
|
||||
<p>
|
||||
<code>[delaytime]</code><br /> Hiermit kann eine Verzögerung eingestellt werden, die vor dem Starten des Netzwerks gewartet wird.</p>
|
||||
<br />
|
||||
<br />
|
||||
<b><code>[delaytime]</code></b><br /> Hiermit kann eine Verzögerung eingestellt werden, die vor dem Starten des Netzwerks gewartet wird.</p>
|
||||
<a name="SONOSset"></a>
|
||||
<h4>Set</h4>
|
||||
<ul>
|
||||
<li><b>Steuerbefehle</b><ul>
|
||||
<li><a name="SONOS_setter_Mute">
|
||||
<code>set <name> Mute <state></code></a>
|
||||
<b><code>Mute <state></code></b></a>
|
||||
<br />Setzt den Mute-Zustand bei allen Playern.</li>
|
||||
<li><a name="SONOS_setter_PauseAll">
|
||||
<code>set <name> PauseAll</code></a>
|
||||
<b><code>PauseAll</code></b></a>
|
||||
<br />Pausiert die Wiedergabe in allen Zonen.</li>
|
||||
<li><a name="SONOS_setter_Pause">
|
||||
<code>set <name> Pause</code></a>
|
||||
<b><code>Pause</code></b></a>
|
||||
<br />Synonym für PauseAll.</li>
|
||||
<li><a name="SONOS_setter_StopAll">
|
||||
<code>set <name> StopAll</code></a>
|
||||
<b><code>StopAll</code></b></a>
|
||||
<br />Stoppt die Wiedergabe in allen Zonen.</li>
|
||||
<li><a name="SONOS_setter_Stop">
|
||||
<code>set <name> Stop</code></a>
|
||||
<b><code>Stop</code></b></a>
|
||||
<br />Synonym für StopAll.</li>
|
||||
</ul></li>
|
||||
<li><b>Gruppenbefehle</b><ul>
|
||||
<li><a name="SONOS_setter_Groups">
|
||||
<code>set <name> Groups <GroupDefinition></code></a>
|
||||
<b><code>Groups <GroupDefinition></code></b></a>
|
||||
<br />Setzt die aktuelle Gruppierungskonfiguration der Sonos-Systemlandschaft. Das Format ist jenes, welches auch von dem Get-Befehl 'Groups' geliefert wird.</li>
|
||||
</ul></li>
|
||||
</ul>
|
||||
@ -7123,7 +7135,7 @@ Man kann den Server unabhängig von FHEM selbst starten (um ihn dauerhaft und un
|
||||
<ul>
|
||||
<li><b>Gruppenbefehle</b><ul>
|
||||
<li><a name="SONOS_getter_Groups">
|
||||
<code>get <name> Groups</code></a>
|
||||
<b><code>Groups</code></b></a>
|
||||
<br />Liefert die aktuelle Gruppierungskonfiguration der Sonos Systemlandschaft zurück. Das Format ist eine Kommagetrennte Liste von Listen mit Devicenamen, also z.B. <code>[Sonos_Kueche], [Sonos_Wohnzimmer, Sonos_Schlafzimmer]</code>. In diesem Beispiel sind also zwei Gruppen definiert, von denen die erste aus einem Player und die zweite aus Zwei Playern besteht.<br />
|
||||
Dabei ist die Reihenfolge innerhalb der Unterlisten wichtig, da der erste Eintrag der sogenannte Gruppenkoordinator ist (in diesem Fall also <code>Sonos_Wohnzimmer</code>), von dem die aktuelle Abspielliste un der aktuelle Titel auf die anderen Gruppenmitglieder übernommen wird.</li>
|
||||
</ul></li>
|
||||
@ -7134,49 +7146,49 @@ Dabei ist die Reihenfolge innerhalb der Unterlisten wichtig, da der erste Eintra
|
||||
'''Hinweis'''<br />Die Attribute werden erst bei einem Neustart von Fhem verwendet, da diese dem SubProzess initial zur Verfügung gestellt werden müssen.
|
||||
<ul>
|
||||
<li><b>Grundsätzliches</b><ul>
|
||||
<li><a name="SONOS_attribut_characterDecoding"><code>attr <name> characterDecoding <codingname></code>
|
||||
<li><a name="SONOS_attribut_characterDecoding"><b><code>characterDecoding <codingname></code></b>
|
||||
</a><br />Hiermit kann die Zeichendekodierung eingestellt werden. Z.b. <UTF-8>. Standardmäßig wird <CP-1252> verwendet.</li>
|
||||
<li><a name="SONOS_attribut_disable"><code>attr <name> disable <value></code>
|
||||
<li><a name="SONOS_attribut_disable"><b><code>disable <value></code></b>
|
||||
</a><br />Eines von (0,1). Hiermit kann das Modul abgeschaltet werden. Wirkt sofort. Bei 1 wird der SubProzess beendet, und somit keine weitere Verarbeitung durchgeführt. Bei 0 wird der Prozess wieder gestartet.<br />Damit kann das Modul temporär abgeschaltet werden, um bei der Neueinrichtung von Sonos-Komponenten keine halben Zustände mitzubekommen.</li>
|
||||
<li><a name="SONOS_attribut_pingType"><code>attr <name> pingType <string></code>
|
||||
<li><a name="SONOS_attribut_pingType"><b><code>pingType <string></code></b>
|
||||
</a><br /> Eines von (none,tcp,udp,icmp,syn). Gibt an, welche Methode für die Ping-Überprüfung verwendet werden soll. Wenn 'none' angegeben wird, dann wird keine Überprüfung gestartet.</li>
|
||||
</ul></li>
|
||||
<li><b>Proxy-Einstellungen</b><ul>
|
||||
<li><a name="SONOS_attribut_generateProxyAlbumArtURLs"><code>attr <name> generateProxyAlbumArtURLs <int></code>
|
||||
<li><a name="SONOS_attribut_generateProxyAlbumArtURLs"><b><code>generateProxyAlbumArtURLs <int></code></b>
|
||||
</a><br /> Aus (0, 1). Wenn aktiviert, werden alle Cober-Links als Proxy-Aufrufe an Fhem generiert. Dieser Proxy-Server wird vom Sonos-Modul bereitgestellt. In der Grundeinstellung erfolgt kein Caching der Cover, sondern nur eine Durchreichung der Cover von den Sonosplayern (Damit ist der Zugriff durch einen externen Proxyserver auf Fhem möglich).</li>
|
||||
<li><a name="SONOS_attribut_proxyCacheDir"><code>attr <name> proxyCacheDir <Path></code>
|
||||
<li><a name="SONOS_attribut_proxyCacheDir"><b><code>proxyCacheDir <Path></code></b>
|
||||
</a><br /> Hiermit wird das Verzeichnis festgelegt, in dem die Cober zwischengespeichert werden. Wenn nicht festegelegt, so wird "/tmp" verwendet.</li>
|
||||
<li><a name="SONOS_attribut_proxyCacheTime"><code>attr <name> proxyCacheTime <int></code>
|
||||
<li><a name="SONOS_attribut_proxyCacheTime"><b><code>proxyCacheTime <int></code></b>
|
||||
</a><br /> Mit einer Angabe ungleich 0 wird der Caching-Mechanismus des Sonos-Modul-Proxy-Servers aktiviert. Dabei werden Cover, die im Cache älter sind als diese Zeitangabe in Sekunden, neu vom Sonosplayer geladen, alle anderen direkt ausgeliefert, ohne den Player zu fragen.</li>
|
||||
</ul></li>
|
||||
<li><b>Sprachoptionen</b><ul>
|
||||
<li><a name="SONOS_attribut_targetSpeakDir"><code>attr <name> targetSpeakDir <string></code>
|
||||
<li><a name="SONOS_attribut_targetSpeakDir"><b><code>targetSpeakDir <string></code></b>
|
||||
</a><br /> Gibt an, welches Verzeichnis für die Ablage des MP3-Files der Textausgabe verwendet werden soll</li>
|
||||
<li><a name="SONOS_attribut_targetSpeakURL"><code>attr <name> targetSpeakURL <string></code>
|
||||
<li><a name="SONOS_attribut_targetSpeakURL"><b><code>targetSpeakURL <string></code></b>
|
||||
</a><br /> Gibt an, unter welcher Adresse der ZonePlayer das unter targetSpeakDir angegebene Verzeichnis erreichen kann.</li>
|
||||
<li><a name="SONOS_attribut_targetSpeakFileTimestamp"><code>attr <name> targetSpeakFileTimestamp <int></code>
|
||||
<li><a name="SONOS_attribut_targetSpeakFileTimestamp"><b><code>targetSpeakFileTimestamp <int></code></b>
|
||||
</a><br /> One of (0, 1). Gibt an, ob die erzeugte MP3-Sprachausgabedatei einen Zeitstempel erhalten soll (1) oder nicht (0).</li>
|
||||
<li><a name="SONOS_attribut_targetSpeakFileHashCache"><code>attr <name> targetSpeakFileHashCache <int></code>
|
||||
<li><a name="SONOS_attribut_targetSpeakFileHashCache"><b><code>targetSpeakFileHashCache <int></code></b>
|
||||
</a><br /> One of (0, 1). Gibt an, ob die erzeugte Sprachausgabedatei einen Hashwert erhalten soll (1) oder nicht (0). Wenn dieser Wert gesetzt wird, dann wird eine bereits bestehende Datei wiederverwendet, und nicht neu erzeugt.</li>
|
||||
<li><a name="SONOS_attribut_Speak1"><code>attr <name> Speak1 <Fileextension>:<Commandline></code>
|
||||
<li><a name="SONOS_attribut_Speak1"><b><code>Speak1 <Fileextension>:<Commandline></code></b>
|
||||
</a><br />Hiermit kann ein Systemaufruf definiert werden, der zu Erzeugung einer Sprachausgabe verwendet werden kann. Sobald dieses Attribut definiert wurde, ist ein entsprechender Setter am Sonosplayer verfügbar.<br />Es dürfen folgende Platzhalter verwendet werden:<br />'''%language%''': Wird durch die eingegebene Sprache ersetzt<br />'''%filename%''': Wird durch den kompletten Dateinamen (inkl. Dateiendung) ersetzt.<br />'''%text%''': Wird durch den zu übersetzenden Text ersetzt.</li>
|
||||
<li><a name="SONOS_attribut_Speak2"><code>attr <name> Speak2 <Fileextension>:<Commandline></code>
|
||||
<li><a name="SONOS_attribut_Speak2"><b><code>Speak2 <Fileextension>:<Commandline></code></b>
|
||||
</a><br />Siehe Speak1</li>
|
||||
<li><a name="SONOS_attribut_Speak3"><code>attr <name> Speak3 <Fileextension>:<Commandline></code>
|
||||
<li><a name="SONOS_attribut_Speak3"><b><code>Speak3 <Fileextension>:<Commandline></code></b>
|
||||
</a><br />Siehe Speak1</li>
|
||||
<li><a name="SONOS_attribut_Speak4"><code>attr <name> Speak4 <Fileextension>:<Commandline></code>
|
||||
<li><a name="SONOS_attribut_Speak4"><b><code>Speak4 <Fileextension>:<Commandline></code></b>
|
||||
</a><br />Siehe Speak1</li>
|
||||
<li><a name="SONOS_attribut_SpeakCover"><code>attr <name> SpeakCover <Absolute-Imagepath></code>
|
||||
<li><a name="SONOS_attribut_SpeakCover"><b><code>SpeakCover <Absolute-Imagepath></code></b>
|
||||
</a><br />Hiermit kann ein JPG- oder PNG-Bild als Cover für die Sprachdurchsagen definiert werden.</li>
|
||||
<li><a name="SONOS_attribut_Speak1Cover"><code>attr <name> Speak1Cover <Absolute-Imagepath></code>
|
||||
<li><a name="SONOS_attribut_Speak1Cover"><b><code>Speak1Cover <Absolute-Imagepath></code></b>
|
||||
</a><br />Analog zu SpeakCover für Speak1.</li>
|
||||
<li><a name="SONOS_attribut_Speak2Cover"><code>attr <name> Speak2Cover <Absolute-Imagepath></code>
|
||||
<li><a name="SONOS_attribut_Speak2Cover"><b><code>Speak2Cover <Absolute-Imagepath></code></b>
|
||||
</a><br />Analog zu SpeakCover für Speak2.</li>
|
||||
<li><a name="SONOS_attribut_Speak3Cover"><code>attr <name> Speak3Cover <Absolute-Imagepath></code>
|
||||
<li><a name="SONOS_attribut_Speak3Cover"><b><code>Speak3Cover <Absolute-Imagepath></code></b>
|
||||
</a><br />Analog zu SpeakCover für Speak3.</li>
|
||||
<li><a name="SONOS_attribut_Speak3Cover"><code>attr <name> Speak3Cover <Absolute-Imagepath></code>
|
||||
<li><a name="SONOS_attribut_Speak3Cover"><b><code>Speak3Cover <Absolute-Imagepath></code></b>
|
||||
</a><br />Analog zu SpeakCover für Speak3.</li>
|
||||
<li><a name="SONOS_attribut_Speak4Cover"><code>attr <name> Speak4Cover <Absolute-Imagepath></code>
|
||||
<li><a name="SONOS_attribut_Speak4Cover"><b><code>Speak4Cover <Absolute-Imagepath></code></b>
|
||||
</a><br />Analog zu SpeakCover für Speak4.</li>
|
||||
</ul></li>
|
||||
</ul>
|
||||
|
||||
@ -823,6 +823,42 @@ sub SONOSPLAYER_GetMasterPlayerName($) {
|
||||
return SONOSPLAYER_GetRealTargetPlayerHash(SONOS_getDeviceDefHash($name))->{NAME};
|
||||
}
|
||||
|
||||
########################################################################################
|
||||
#
|
||||
# SONOSPLAYER_GetSlavePlayerNames - Retreives all slave Players of the given player
|
||||
#
|
||||
# Parameter name = name of device, for which the group is searched
|
||||
#
|
||||
########################################################################################
|
||||
sub SONOSPLAYER_GetSlavePlayerNames($) {
|
||||
my ($name) = @_;
|
||||
|
||||
my $hash = SONOS_getDeviceDefHash($name);
|
||||
my $sonosHash = SONOS_getDeviceDefHash(undef);
|
||||
|
||||
my @groups = SONOS_ConvertZoneGroupState(ReadingsVal($sonosHash->{NAME}, 'ZoneGroupState', ''));
|
||||
|
||||
for my $group (@groups) {
|
||||
for my $elem (@{$group}) {
|
||||
if ($hash->{UDN} eq $elem) {
|
||||
# Diese Liste brauchen wir, aber ohne das erste Element (der Master)...
|
||||
shift(@{$group});
|
||||
|
||||
# UDNs in Devicenamen umwandeln...
|
||||
foreach my $elem (@{$group}) {
|
||||
$elem = SONOS_getSonosPlayerByUDN($elem)->{NAME};
|
||||
}
|
||||
|
||||
# Liste zurückgeben
|
||||
return sort(@{$group});
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
# Nix gefunden... also leere Liste liefern... Sollte nicht vorkommen...
|
||||
return ();
|
||||
}
|
||||
|
||||
########################################################################################
|
||||
#
|
||||
# SONOSPLAYER_Undef - Implements UndefFn function
|
||||
@ -900,169 +936,166 @@ sub SONOSPLAYER_Log($$$) {
|
||||
<p>
|
||||
<code>define Sonos_Wohnzimmer SONOSPLAYER RINCON_000EFEFEFEF401400_MR</code>
|
||||
</p>
|
||||
<br />
|
||||
<a name="SONOSPLAYERdefine"></a>
|
||||
<h4>Define</h4>
|
||||
<code>define <name> SONOSPLAYER <udn></code>
|
||||
<b><code>define <name> SONOSPLAYER <udn></code></b>
|
||||
<p>
|
||||
<code><udn></code><br /> MAC-Address based identifier of the zoneplayer</p>
|
||||
<br />
|
||||
<br />
|
||||
<b><code><udn></code></b><br /> MAC-Address based identifier of the zoneplayer</p>
|
||||
<a name="SONOSPLAYERset"></a>
|
||||
<h4>Set</h4>
|
||||
<ul>
|
||||
<li><b>Common Tasks</b><ul>
|
||||
<li><a name="SONOSPLAYER_setter_Alarm">
|
||||
<code>set <name> Alarm (Create|Update|Delete) <ID> <Datahash></code></a>
|
||||
<b><code>Alarm (Create|Update|Delete) <ID> <Datahash></code></b></a>
|
||||
<br />Can be used for working on alarms:<ul><li><b>Create:</b> Creates an alarm-entry with the given datahash.</li><li><b>Update:</b> Updates the alarm-entry with the given id and datahash.</li><li><b>Delete:</b> Deletes the alarm-entry with the given id.</li></ul><br /><b>The Datahash:</b><br />The Format is a perl-hash and is interpreted with the eval-function.<br />e.g.: { Repeat => 1 }<br /><br />The following entries are allowed/neccessary:<ul><li>StartTime</li><li>Duration</li><li>Recurrence_Once</li><li>Recurrence_Monday</li><li>Recurrence_Tuesday</li><li>Recurrence_Wednesday</li><li>Recurrence_Thursday</li><li>Recurrence_Friday</li><li>Recurrence_Saturday</li><li>Recurrence_Sunday</li><li>Enabled</li><li>ProgramURI</li><li>ProgramMetaData</li><li>Shuffle</li><li>Repeat</li><li>Volume</li><li>IncludeLinkedZones</li></ul><br />e.g.:<ul><li>set Sonos_Wohnzimmer Alarm Create 0 { Enabled => 1, Volume => 35, StartTime => '00:00:00', Duration => '00:15:00', Repeat => 0, Shuffle => 0, ProgramURI => 'x-rincon-buzzer:0', ProgramMetaData => '', Recurrence_Once => 0, Recurrence_Monday => 1, Recurrence_Tuesday => 1, Recurrence_Wednesday => 1, Recurrence_Thursday => 1, Recurrence_Friday => 1, Recurrence_Saturday => 0, Recurrence_Sunday => 0, IncludeLinkedZones => 0 }</li><li>set Sonos_Wohnzimmer Alarm Update 17 { Shuffle => 1 }</li><li>set Sonos_Wohnzimmer Alarm Delete 17 {}</li></ul></li>
|
||||
<li><a name="SONOSPLAYER_setter_DailyIndexRefreshTime">
|
||||
<code>set <name> DailyIndexRefreshTime <time></code></a>
|
||||
<b><code>DailyIndexRefreshTime <time></code></b></a>
|
||||
<br />Sets the current DailyIndexRefreshTime for the whole bunch of Zoneplayers.</li>
|
||||
<li><a name="SONOSPLAYER_setter_Name">
|
||||
<code>set <name> Name <Zonename></code></a>
|
||||
<b><code>Name <Zonename></code></b></a>
|
||||
<br />Sets the Name for this Zone</li>
|
||||
<li><a name="SONOSPLAYER_setter_Reboot">
|
||||
<code>set <name> Reboot</code></a>
|
||||
<b><code>Reboot</code></b></a>
|
||||
<br />Initiates a reboot on the Zoneplayer.</li>
|
||||
<li><a name="SONOSPLAYER_setter_RoomIcon">
|
||||
<code>set <name> RoomIcon <Iconname></code></a>
|
||||
<b><code>RoomIcon <Iconname></code></b></a>
|
||||
<br />Sets the Icon for this Zone</li>
|
||||
<li><a name="SONOSPLAYER_setter_Wifi">
|
||||
<code>set <name> Wifi <State></code></a>
|
||||
<b><code>Wifi <State></code></b></a>
|
||||
<br />Sets the WiFi-State of the given Player. Can be 'off', 'persist-off' or 'on'.</li>
|
||||
</ul></li>
|
||||
<li><b>Playing Control-Commands</b><ul>
|
||||
<li><a name="SONOSPLAYER_setter_CurrentTrackPosition">
|
||||
<code>set <name> CurrentTrackPosition <TimePosition></code></a>
|
||||
<b><code>CurrentTrackPosition <TimePosition></code></b></a>
|
||||
<br /> Sets the current timeposition inside the title to the given value.</li>
|
||||
<li><a name="SONOSPLAYER_setter_Pause">
|
||||
<code>set <name> Pause</code></a>
|
||||
<b><code>Pause</code></b></a>
|
||||
<br /> Pause the playing</li>
|
||||
<li><a name="SONOSPLAYER_setter_Previous">
|
||||
<code>set <name> Previous</code></a>
|
||||
<b><code>Previous</code></b></a>
|
||||
<br /> Jumps to the beginning of the previous title.</li>
|
||||
<li><a name="SONOSPLAYER_setter_Play">
|
||||
<code>set <name> Play</code></a>
|
||||
<b><code>Play</code></b></a>
|
||||
<br /> Starts playing</li>
|
||||
<li><a name="SONOSPLAYER_setter_PlayURI">
|
||||
<code>set <name> PlayURI <songURI> [Volume]</code></a>
|
||||
<b><code>PlayURI <songURI> [Volume]</code></b></a>
|
||||
<br />Plays the given MP3-File with the optional given volume.</li>
|
||||
<li><a name="SONOSPLAYER_setter_PlayURITemp">
|
||||
<code>set <name> PlayURITemp <songURI> [Volume]</code></a>
|
||||
<b><code>PlayURITemp <songURI> [Volume]</code></b></a>
|
||||
<br />Plays the given MP3-File with the optional given volume as a temporary file. After playing it, the whole state is reconstructed and continues playing at the former saved position and volume and so on. If the file given is a stream (exactly: a file where the running time could not be determined), the call would be identical to <code>,PlayURI</code>, e.g. nothing is restored after playing.</li>
|
||||
<li><a name="SONOSPLAYER_setter_Next">
|
||||
<code>set <name> Next</code></a>
|
||||
<b><code>Next</code></b></a>
|
||||
<br /> Jumps to the beginning of the next title</li>
|
||||
<li><a name="SONOSPLAYER_setter_Speak">
|
||||
<code>set <name> Speak <Volume> <Language> <Text></code></a>
|
||||
<b><code>Speak <Volume> <Language> <Text></code></b></a>
|
||||
<br />Uses the Google Text-To-Speech-Engine for generating MP3-Files of the given text and plays it on the SonosPlayer. Possible languages can be obtained from Google. e.g. "de", "en", "fr", "es"...</li>
|
||||
<li><a name="SONOSPLAYER_setter_StartFavourite">
|
||||
<code>set <name> StartFavourite <Favouritename> [NoStart]</code></a>
|
||||
<b><code>StartFavourite <Favouritename> [NoStart]</code></b></a>
|
||||
<br /> Starts the named sonos-favorite. The parameter should be URL-encoded for proper naming of lists with special characters. If the Word 'NoStart' is given as second parameter, than the Loading will be done, but the playing-state is leaving untouched e.g. not started.<br />Additionally it's possible to use a regular expression as the name. The first hit will be used. The format is e.g. <code>/meine.hits/</code>.</li>
|
||||
<li><a name="SONOSPLAYER_setter_StartPlaylist">
|
||||
<code>set <name> StartPlaylist <Playlistname> [EmptyQueueBeforeImport]</code></a>
|
||||
<b><code>StartPlaylist <Playlistname> [EmptyQueueBeforeImport]</code></b></a>
|
||||
<br /> Loads the given Playlist and starts playing immediately. For all Options have a look at "LoadPlaylist".</li>
|
||||
<li><a name="SONOSPLAYER_setter_StartRadio">
|
||||
<code>set <name> StartRadio <Radiostationname></code></a>
|
||||
<b><code>StartRadio <Radiostationname></code></b></a>
|
||||
<br /> Loads the named radiostation (favorite) and starts playing immediately. For all Options have a look at "LoadRadio".</li>
|
||||
<li><a name="SONOSPLAYER_setter_Stop">
|
||||
<code>set <name> Stop</code></a>
|
||||
<b><code>Stop</code></b></a>
|
||||
<br /> Stops the playing</li>
|
||||
<li><a name="SONOSPLAYER_setter_Track">
|
||||
<code>set <name> Track <TrackNumber|Random></code></a>
|
||||
<b><code>Track <TrackNumber|Random></code></b></a>
|
||||
<br /> Sets the track with the given tracknumber as the current title. If the tracknumber is the word <code>Random</code> a random track will be selected.</li>
|
||||
</ul></li>
|
||||
<li><b>Playing Settings</b><ul>
|
||||
<li><a name="SONOSPLAYER_setter_Balance">
|
||||
<code>set <name> Balance <BalanceValue></code></a>
|
||||
<b><code>Balance <BalanceValue></code></b></a>
|
||||
<br /> Sets the balance to the given value. The value can range from -100 (full left) to 100 (full right). Retrieves the new balancevalue as the result.</li>
|
||||
<li><a name="SONOSPLAYER_setter_Bass">
|
||||
<code>set <name> Bass <BassValue></code></a>
|
||||
<b><code>Bass <BassValue></code></b></a>
|
||||
<br /> Sets the bass to the given value. The value can range from -10 to 10. Retrieves the new bassvalue as the result.</li>
|
||||
<li><a name="SONOSPLAYER_setter_CrossfadeMode">
|
||||
<code>set <name> CrossfadeMode <State></code></a>
|
||||
<b><code>CrossfadeMode <State></code></b></a>
|
||||
<br /> Sets the crossfade-mode. Retrieves the new mode as the result.</li>
|
||||
<li><a name="SONOSPLAYER_setter_LEDState">
|
||||
<code>set <name> LEDState <State></code></a>
|
||||
<b><code>LEDState <State></code></b></a>
|
||||
<br /> Sets the LED state. Retrieves the new state as the result.</li>
|
||||
<li><a name="SONOSPLAYER_setter_Loudness">
|
||||
<code>set <name> Loudness <State></code></a>
|
||||
<b><code>Loudness <State></code></b></a>
|
||||
<br /> Sets the loudness-state. Retrieves the new state as the result.</li>
|
||||
<li><a name="SONOSPLAYER_setter_Mute">
|
||||
<code>set <name> Mute <State></code></a>
|
||||
<b><code>Mute <State></code></b></a>
|
||||
<br /> Sets the mute-state. Retrieves the new state as the result.</li>
|
||||
<li><a name="SONOSPLAYER_setter_MuteT">
|
||||
<code>set <name> MuteT</code></a>
|
||||
<b><code>MuteT</code></b></a>
|
||||
<br /> Toggles the mute state. Retrieves the new state as the result.</li>
|
||||
<li><a name="SONOSPLAYER_setter_Repeat">
|
||||
<code>set <name> Repeat <State></code></a>
|
||||
<b><code>Repeat <State></code></b></a>
|
||||
<br /> Sets the repeat-state. Retrieves the new state as the result.</li>
|
||||
<li><a name="SONOSPLAYER_setter_Shuffle">
|
||||
<code>set <name> Shuffle <State></code></a>
|
||||
<b><code>Shuffle <State></code></b></a>
|
||||
<br /> Sets the shuffle-state. Retrieves the new state as the result.</li>
|
||||
<li><a name="SONOSPLAYER_setter_SleepTimer">
|
||||
<code>set <name> SleepTimer <Time></code></a>
|
||||
<b><code>SleepTimer <Time></code></b></a>
|
||||
<br /> Sets the Sleeptimer to the given Time. It must be in the full format of "HH:MM:SS". Deactivate with "00:00:00" or "off".</li>
|
||||
<li><a name="SONOSPLAYER_setter_Treble">
|
||||
<code>set <name> Treble <TrebleValue></code></a>
|
||||
<b><code>Treble <TrebleValue></code></b></a>
|
||||
<br /> Sets the treble to the given value. The value can range from -10 to 10. Retrieves the new treblevalue as the result.</li>
|
||||
<li><a name="SONOSPLAYER_setter_Volume">
|
||||
<code>set <name> Volume <VolumeLevel> [RampType]</code></a>
|
||||
<b><code>Volume <VolumeLevel> [RampType]</code></b></a>
|
||||
<br /> Sets the volume to the given value. The value could be a relative value with + or - sign. In this case the volume will be increased or decreased according to this value. Retrieves the new volume as the result.<br />Optional can be a RampType defined with a value between 1 and 3 which describes different templates defined by the Sonos-System.</li>
|
||||
<li><a name="SONOSPLAYER_setter_VolumeD">
|
||||
<code>set <name> VolumeD</code></a>
|
||||
<b><code>VolumeD</code></b></a>
|
||||
<br /> Turns the volume by volumeStep-ticks down.</li>
|
||||
<li><a name="SONOSPLAYER_setter_VolumeRestore">
|
||||
<code>set <name> VolumeRestore</code></a>
|
||||
<b><code>VolumeRestore</code></b></a>
|
||||
<br /> Restores the volume of a formerly saved volume.</li>
|
||||
<li><a name="SONOSPLAYER_setter_VolumeSave">
|
||||
<code>set <name> VolumeSave <VolumeLevel></code></a>
|
||||
<b><code>VolumeSave <VolumeLevel></code></b></a>
|
||||
<br /> Sets the volume to the given value. The value could be a relative value with + or - sign. In this case the volume will be increased or decreased according to this value. Retrieves the new volume as the result. Additionally it saves the old volume to a reading for restoreing.</li>
|
||||
<li><a name="SONOSPLAYER_setter_VolumeU">
|
||||
<code>set <name> VolumeU</code></a>
|
||||
<b><code>VolumeU</code></b></a>
|
||||
<br /> Turns the volume by volumeStep-ticks up.</li>
|
||||
</ul></li>
|
||||
<li><b>Control the current Playlist</b><ul>
|
||||
<li><a name="SONOSPLAYER_setter_AddURIToQueue">
|
||||
<code>set <name> AddURIToQueue <songURI></code></a>
|
||||
<b><code>AddURIToQueue <songURI></code></b></a>
|
||||
<br />Adds the given MP3-File at the current position into the queue.</li>
|
||||
<li><a name="SONOSPLAYER_setter_CurrentPlaylist">
|
||||
<code>set <name> CurrentPlaylist</code></a>
|
||||
<b><code>CurrentPlaylist</code></b></a>
|
||||
<br /> Sets the current playing to the current queue, but doesn't start playing (e.g. after hearing of a radiostream, where the current playlist still exists but is currently "not in use")</li>
|
||||
<li><a name="SONOSPLAYER_setter_EmptyPlaylist">
|
||||
<code>set <name> EmptyPlaylist</code></a>
|
||||
<b><code>EmptyPlaylist</code></b></a>
|
||||
<br /> Clears the current queue</li>
|
||||
<li><a name="SONOSPLAYER_setter_LoadPlaylist">
|
||||
<code>set <name> LoadPlaylist <Playlistname> [EmptyQueueBeforeImport]</code></a>
|
||||
<b><code>LoadPlaylist <Playlistname> [EmptyQueueBeforeImport]</code></b></a>
|
||||
<br /> Loads the named playlist to the current playing queue. The parameter should be URL-encoded for proper naming of lists with special characters. The Playlistname can be a filename and then must be startet with 'file:' (e.g. 'file:c:/Test.m3u')<br />If EmptyQueueBeforeImport is given and set to 1, the queue will be emptied before the import process. If not given, the parameter will be interpreted as 1.<br />Additionally it's possible to use a regular expression as the name. The first hit will be used. The format is e.g. <code>/hits.2014/</code>.</li>
|
||||
<li><a name="SONOSPLAYER_setter_LoadRadio">
|
||||
<code>set <name> LoadRadio <Radiostationname></code></a>
|
||||
<b><code>LoadRadio <Radiostationname></code></b></a>
|
||||
<br /> Loads the named radiostation (favorite). The current queue will not be touched but deactivated. The parameter should be URL-encoded for proper naming of lists with special characters.<br />Additionally it's possible to use a regular expression as the name. The first hit will be used. The format is e.g. <code>/radio/</code>.</li>
|
||||
<li><a name="SONOSPLAYER_setter_SavePlaylist">
|
||||
<code>set <name> SavePlaylist <Playlistname></code></a>
|
||||
<b><code>SavePlaylist <Playlistname></code></b></a>
|
||||
<br /> Saves the current queue as a playlist with the given name. An existing playlist with the same name will be overwritten. The parameter should be URL-encoded for proper naming of lists with special characters. The Playlistname can be a filename and then must be startet with 'file:' (e.g. 'file:c:/Test.m3u')</li>
|
||||
</ul></li>
|
||||
<li><b>Groupcontrol</b><ul>
|
||||
<li><a name="SONOSPLAYER_setter_AddMember">
|
||||
<code>set <name> AddMember <devicename></code></a>
|
||||
<b><code>AddMember <devicename></code></b></a>
|
||||
<br />Adds the given devicename to the current device as a groupmember. The current playing of the current device goes on and will be transfered to the given device (the new member).</li>
|
||||
<li><a name="SONOSPLAYER_setter_CreateStereoPair">
|
||||
<code>set <name> CreateStereoPair <rightPlayerDevicename></code></a>
|
||||
<b><code>CreateStereoPair <rightPlayerDevicename></code></b></a>
|
||||
<br />Adds the given devicename to the current device as the right speaker of a stereopair. The current playing of the current device goes on (as left-side speaker) and will be transfered to the given device (as right-side speaker).</li>
|
||||
<li><a name="SONOSPLAYER_setter_GroupMute">
|
||||
<code>set <name> GroupMute <State></code></a>
|
||||
<b><code>GroupMute <State></code></b></a>
|
||||
<br />Sets the mute state of the complete group in one step. The value can be on or off.</li>
|
||||
<li><a name="SONOSPLAYER_setter_GroupVolume">
|
||||
<code>set <name> GroupVolume <VolumeLevel></code></a>
|
||||
<b><code>GroupVolume <VolumeLevel></code></b></a>
|
||||
<br />Sets the group-volume in the way the original controller does. This means, that the relative volumelevel between the different players will be saved during change.</li>
|
||||
<li><a name="SONOSPLAYER_setter_RemoveMember">
|
||||
<code>set <name> RemoveMember <devicename></code></a>
|
||||
<b><code>RemoveMember <devicename></code></b></a>
|
||||
<br />Removes the given device, so that they both are not longer a group. The current playing of the current device goes on normally. The cutted device stops his playing and has no current playlist anymore (since Sonos Version 4.2 the old playlist will be restored).</li>
|
||||
<li><a name="SONOSPLAYER_setter_SeparateStereoPair">
|
||||
<code>set <name> SeparateStereoPair</code></a>
|
||||
<b><code>SeparateStereoPair</code></b></a>
|
||||
<br />Divides the stereo-pair into two independant devices.</li>
|
||||
<li><a name="SONOSPLAYER_setter_SnapshotGroupVolume">
|
||||
<code>set <name> SnapshotGroupVolume</code></a>
|
||||
<b><code>SnapshotGroupVolume</code></b></a>
|
||||
<br /> Save the current volume-relation of all players of the same group. It's neccessary for the use of "GroupVolume" and is stored until the next call of "SnapshotGroupVolume".</li>
|
||||
</ul></li>
|
||||
</ul>
|
||||
@ -1072,38 +1105,38 @@ sub SONOSPLAYER_Log($$$) {
|
||||
<ul>
|
||||
<li><b>Common</b><ul>
|
||||
<li><a name="SONOSPLAYER_getter_Alarm">
|
||||
<code>get <name> Alarm <ID></code></a>
|
||||
<b><code>Alarm <ID></code></b></a>
|
||||
<br /> It's an exception to the normal getter semantics. Returns directly a Perl-Hash with the Alarm-Informations to the given id. It's just a shorthand for <code>eval(ReadingsVal(<Devicename>, 'Alarmlist', ()))->{<ID>};</code>.</li>
|
||||
<li><a name="SONOSPLAYER_getter_EthernetPortStatus">
|
||||
<code>get <name> EthernetPortStatus <PortNumber></code></a>
|
||||
<b><code>EthernetPortStatus <PortNumber></code></b></a>
|
||||
<br /> Gets the Ethernet-Portstatus of the given Port. Can be 'Active' or 'Inactive'.</li>
|
||||
<li><a name="SONOSPLAYER_getter_PossibleRoomIcons">
|
||||
<code>get <name> PossibleRoomIcons</code></a>
|
||||
<b><code>PossibleRoomIcons</code></b></a>
|
||||
<br /> Retreives a list of all possible Roomiconnames for the use with "set RoomIcon".</li>
|
||||
</ul></li>
|
||||
<li><b>Lists</b><ul>
|
||||
<li><a name="SONOSPLAYER_getter_Favourites">
|
||||
<code>get <name> Favourites</code></a>
|
||||
<b><code>Favourites</code></b></a>
|
||||
<br /> Retrieves a list with the names of all sonos favourites. This getter retrieves the same list on all Zoneplayer. The format is a comma-separated list with quoted names of favourites. e.g. "Liste 1","Entry 2","Test"</li>
|
||||
<li><a name="SONOSPLAYER_getter_FavouritesWithCovers">
|
||||
<code>get <name> FavouritesWithCovers</code></a>
|
||||
<b><code>FavouritesWithCovers</code></b></a>
|
||||
<br /> Retrieves a list with the stringrepresentation of a perl-hash which can easily be converted with "eval". It consists of the names and coverlinks of all of the favourites stored in Sonos e.g. {'FV:2/22' => {'Cover' => 'urlzumcover', 'Title' => '1. Favorit'}}</li>
|
||||
<li><a name="SONOSPLAYER_getter_Playlists">
|
||||
<code>get <name> Playlists</code></a>
|
||||
<b><code>Playlists</code></b></a>
|
||||
<br /> Retrieves a list with the names of all saved queues (aka playlists). This getter retrieves the same list on all Zoneplayer. The format is a comma-separated list with quoted names of playlists. e.g. "Liste 1","Liste 2","Test"</li>
|
||||
<li><a name="SONOSPLAYER_getter_PlaylistsWithCovers">
|
||||
<code>get <name> PlaylistsWithCovers</code></a>
|
||||
<b><code>PlaylistsWithCovers</code></b></a>
|
||||
<br /> Retrieves a list with the stringrepresentation of a perl-hash which can easily be converted with "eval". It consists of the names and coverlinks of all of the playlists stored in Sonos e.g. {'SQ:14' => {'Cover' => 'urlzumcover', 'Title' => '1. Playlist'}}</li>
|
||||
<li><a name="SONOSPLAYER_getter_Radios">
|
||||
<code>get <name> Radios</code></a>
|
||||
<b><code>Radios</code></b></a>
|
||||
<br /> Retrieves a list woth the names of all saved radiostations (favorites). This getter retrieves the same list on all Zoneplayer. The format is a comma-separated list with quoted names of radiostations. e.g. "Sender 1","Sender 2","Test"</li>
|
||||
<li><a name="SONOSPLAYER_getter_RadiosWithCovers">
|
||||
<code>get <name> RadiosWithCovers</code></a>
|
||||
<b><code>RadiosWithCovers</code></b></a>
|
||||
<br /> Retrieves a list with the stringrepresentation of a perl-hash which can easily be converted with "eval". It consists of the names and coverlinks of all of the radiofavourites stored in Sonos e.g. {'R:0/0/2' => {'Cover' => 'urlzumcover', 'Title' => '1. Radiosender'}}</li>
|
||||
</ul></li>
|
||||
<li><b>Informations on the current Title</b><ul>
|
||||
<li><a name="SONOSPLAYER_getter_CurrentTrackPosition">
|
||||
<code>get <name> CurrentTrackPosition</code></a>
|
||||
<b><code>CurrentTrackPosition</code></b></a>
|
||||
<br /> Retrieves the current timeposition inside a title</li>
|
||||
</ul></li>
|
||||
</ul>
|
||||
@ -1113,41 +1146,41 @@ sub SONOSPLAYER_Log($$$) {
|
||||
'''Attention'''<br />The attributes can only be used after a restart of fhem, because it must be initially transfered to the subprocess.
|
||||
<ul>
|
||||
<li><b>Common</b><ul>
|
||||
<li><a name="SONOSPLAYER_attribut_disable"><code>attr <name> disable <int></code>
|
||||
<li><a name="SONOSPLAYER_attribut_disable"><b><code>disable <int></code></b>
|
||||
</a><br /> One of (0,1). Disables the event-worker for this Sonosplayer.</li>
|
||||
<li><a name="SONOSPLAYER_attribut_generateSomethingChangedEvent"><code>attr <name> generateSomethingChangedEvent <int></code>
|
||||
<li><a name="SONOSPLAYER_attribut_generateSomethingChangedEvent"><b><code>generateSomethingChangedEvent <int></code></b>
|
||||
</a><br /> One of (0,1). 1 if a 'SomethingChanged'-Event should be generated. This event is thrown every time an event is generated. This is useful if you wants to be notified on every change with a single event.</li>
|
||||
<li><a name="SONOSPLAYER_attribut_generateVolumeEvent"><code>attr <name> generateVolumeEvent <int></code>
|
||||
<li><a name="SONOSPLAYER_attribut_generateVolumeEvent"><b><code>generateVolumeEvent <int></code></b>
|
||||
</a><br /> One of (0,1). Enables an event generated at volumechanges if minVolume or maxVolume is set.</li>
|
||||
<li><a name="SONOSPLAYER_attribut_generateVolumeSlider"><code>attr <name> generateVolumeSlider <int></code>
|
||||
<li><a name="SONOSPLAYER_attribut_generateVolumeSlider"><b><code>generateVolumeSlider <int></code></b>
|
||||
</a><br /> One of (0,1). Enables a slider for volumecontrol in detail view.</li>
|
||||
<li><a name="SONOSPLAYER_attribut_getAlarms"><code>attr <name> getAlarms <int></code>
|
||||
<li><a name="SONOSPLAYER_attribut_getAlarms"><b><code>getAlarms <int></code></b>
|
||||
</a><br /> One of (0..1). Initializes a callback-method for Alarms. This included the information of the DailyIndexRefreshTime.</li>
|
||||
<li><a name="SONOSPLAYER_attribut_volumeStep"><code>attr <name> volumeStep <int></code>
|
||||
<li><a name="SONOSPLAYER_attribut_volumeStep"><b><code>volumeStep <int></code></b>
|
||||
</a><br /> One of (0..100). Defines the stepwidth for subsequent calls of <code>VolumeU</code> and <code>VolumeD</code>.</li>
|
||||
</ul></li>
|
||||
<li><b>Information Generation</b><ul>
|
||||
<li><a name="SONOSPLAYER_attribut_generateInfoSummarize1"><code>attr <name> generateInfoSummarize1 <string></code>
|
||||
<li><a name="SONOSPLAYER_attribut_generateInfoSummarize1"><b><code>generateInfoSummarize1 <string></code></b>
|
||||
</a><br /> Generates the reading 'InfoSummarize1' with the given format. More Information on this in the examples-section.</li>
|
||||
<li><a name="SONOSPLAYER_attribut_generateInfoSummarize2"><code>attr <name> generateInfoSummarize2 <string></code>
|
||||
<li><a name="SONOSPLAYER_attribut_generateInfoSummarize2"><b><code>generateInfoSummarize2 <string></code></b>
|
||||
</a><br /> Generates the reading 'InfoSummarize2' with the given format. More Information on this in the examples-section.</li>
|
||||
<li><a name="SONOSPLAYER_attribut_generateInfoSummarize3"><code>attr <name> generateInfoSummarize3 <string></code>
|
||||
<li><a name="SONOSPLAYER_attribut_generateInfoSummarize3"><b><code>generateInfoSummarize3 <string></code></b>
|
||||
</a><br /> Generates the reading 'InfoSummarize3' with the given format. More Information on this in the examples-section.</li>
|
||||
<li><a name="SONOSPLAYER_attribut_generateInfoSummarize4"><code>attr <name> generateInfoSummarize4 <string></code>
|
||||
<li><a name="SONOSPLAYER_attribut_generateInfoSummarize4"><b><code>generateInfoSummarize4 <string></code></b>
|
||||
</a><br /> Generates the reading 'InfoSummarize4' with the given format. More Information on this in the examples-section.</li>
|
||||
<li><a name="SONOSPLAYER_attribut_stateVariable"><code>attr <name> stateVariable <string></code>
|
||||
<li><a name="SONOSPLAYER_attribut_stateVariable"><b><code>stateVariable <string></code></b>
|
||||
</a><br /> One of (TransportState,NumberOfTracks,Track,TrackURI,TrackDuration,Title,Artist,Album,OriginalTrackNumber,AlbumArtist,<br />Sender,SenderCurrent,SenderInfo,StreamAudio,NormalAudio,AlbumArtURI,nextTrackDuration,nextTrackURI,nextAlbumArtURI,<br />nextTitle,nextArtist,nextAlbum,nextAlbumArtist,nextOriginalTrackNumber,Volume,Mute,Shuffle,Repeat,CrossfadeMode,Balance,<br />HeadphoneConnected,SleepTimer,Presence,RoomName,SaveRoomName,PlayerType,Location,SoftwareRevision,SerialNum,InfoSummarize1,<br />InfoSummarize2,InfoSummarize3,InfoSummarize4). Defines, which variable has to be copied to the content of the state-variable.</li>
|
||||
</ul></li>
|
||||
<li><b>Controloptions</b><ul>
|
||||
<li><a name="SONOSPLAYER_attribut_maxVolume"><code>attr <name> maxVolume <int></code>
|
||||
<li><a name="SONOSPLAYER_attribut_maxVolume"><b><code>maxVolume <int></code></b>
|
||||
</a><br /> One of (0..100). Define a maximal volume for this Zoneplayer</li>
|
||||
<li><a name="SONOSPLAYER_attribut_minVolume"><code>attr <name> minVolume <int></code>
|
||||
<li><a name="SONOSPLAYER_attribut_minVolume"><b><code>minVolume <int></code></b>
|
||||
</a><br /> One of (0..100). Define a minimal volume for this Zoneplayer</li>
|
||||
<li><a name="SONOSPLAYER_attribut_maxVolumeHeadphone"><code>attr <name> maxVolumeHeadphone <int></code>
|
||||
<li><a name="SONOSPLAYER_attribut_maxVolumeHeadphone"><b><code>maxVolumeHeadphone <int></code></b>
|
||||
</a><br /> One of (0..100). Define a maximal volume for this Zoneplayer for use with headphones</li>
|
||||
<li><a name="SONOSPLAYER_attribut_minVolumeHeadphone"><code>attr <name> minVolumeHeadphone <int></code>
|
||||
<li><a name="SONOSPLAYER_attribut_minVolumeHeadphone"><b><code>minVolumeHeadphone <int></code></b>
|
||||
</a><br /> One of (0..100). Define a minimal volume for this Zoneplayer for use with headphones</li>
|
||||
<li><a name="SONOSPLAYER_attribut_buttonEvents"><code>attr <name> buttonEvents <Time:Pattern>[ <Time:Pattern> ...]</code>
|
||||
<li><a name="SONOSPLAYER_attribut_buttonEvents"><b><code>buttonEvents <Time:Pattern>[ <Time:Pattern> ...]</code></b>
|
||||
</a><br /> Defines that after pressing a specified sequence of buttons at the player an event has to be thrown. The definition itself is a tupel: the first part (before the colon) is the time in seconds, the second part (after the colon) is the button sequence of this event.<br />
|
||||
The following button-shortcuts are possible: <ul><li><b>M</b>: The Mute-Button</li><li><b>H</b>: The Headphone-Connector</li><li><b>U</b>: Up-Button (Volume Up)</li><li><b>D</b>: Down-Button (Volume Down)</li></ul><br />
|
||||
The event thrown is named <code>ButtonEvent</code>, the value is the defined button-sequence.<br />
|
||||
@ -1155,7 +1188,6 @@ E.G.: <code>2:MM</code><br />
|
||||
Here an event is defined, where in time of 2 seconds the Mute-Button has to be pressed 2 times. The created event is named <code>ButtonEvent</code> and has the value <code>MM</code>.</li>
|
||||
</ul></li>
|
||||
</ul>
|
||||
<br />
|
||||
<a name="SONOSPLAYERexamples"></a>
|
||||
<h4>Examples / Tips</h4>
|
||||
<ul>
|
||||
@ -1179,170 +1211,166 @@ Here an event is defined, where in time of 2 seconds the Mute-Button has to be p
|
||||
<p>
|
||||
<code>define Sonos_Wohnzimmer SONOSPLAYER RINCON_000EFEFEFEF401400_MR</code>
|
||||
</p>
|
||||
<br />
|
||||
<a name="SONOSPLAYERdefine"></a>
|
||||
<h4>Definition</h4>
|
||||
<code>define <name> SONOSPLAYER <udn></code>
|
||||
<b><code>define <name> SONOSPLAYER <udn></code></b>
|
||||
<p>
|
||||
<code><udn></code><br /> MAC-Addressbasierter eindeutiger Bezeichner des Zoneplayer</p>
|
||||
<p>
|
||||
<br />
|
||||
<br />
|
||||
<b><code><udn></code></b><br /> MAC-Addressbasierter eindeutiger Bezeichner des Zoneplayer</p>
|
||||
<a name="SONOSPLAYERset"></a>
|
||||
<h4>Set</h4>
|
||||
<ul>
|
||||
<li><b>Grundsätzliche Einstellungen</b><ul>
|
||||
<li><a name="SONOSPLAYER_setter_Alarm">
|
||||
<code>set <name> Alarm (Create|Update|Delete) <ID> <Datahash></code></a>
|
||||
<b><code>Alarm (Create|Update|Delete) <ID> <Datahash></code></b></a>
|
||||
<br />Diese Anweisung wird für die Bearbeitung der Alarme verwendet:<ul><li><b>Create:</b> Erzeugt einen neuen Alarm-Eintrag mit den übergebenen Hash-Daten.</li><li><b>Update:</b> Aktualisiert den Alarm mit der übergebenen ID und den angegebenen Hash-Daten.</li><li><b>Delete:</b> Löscht den Alarm-Eintrag mit der übergebenen ID.</li></ul><br /><b>Die Hash-Daten:</b><br />Das Format ist ein Perl-Hash und wird mittels der eval-Funktion interpretiert.<br />e.g.: { Repeat => 1 }<br /><br />Die folgenden Schlüssel sind zulässig/notwendig:<ul><li>StartTime</li><li>Duration</li><li>Recurrence_Once</li><li>Recurrence_Monday</li><li>Recurrence_Tuesday</li><li>Recurrence_Wednesday</li><li>Recurrence_Thursday</li><li>Recurrence_Friday</li><li>Recurrence_Saturday</li><li>Recurrence_Sunday</li><li>Enabled</li><li>ProgramURI</li><li>ProgramMetaData</li><li>Shuffle</li><li>Repeat</li><li>Volume</li><li>IncludeLinkedZones</li></ul><br />z.B.:<ul><li>set Sonos_Wohnzimmer Alarm Create 0 { Enabled => 1, Volume => 35, StartTime => '00:00:00', Duration => '00:15:00', Repeat => 0, Shuffle => 0, ProgramURI => 'x-rincon-buzzer:0', ProgramMetaData => '', Recurrence_Once => 0, Recurrence_Monday => 1, Recurrence_Tuesday => 1, Recurrence_Wednesday => 1, Recurrence_Thursday => 1, Recurrence_Friday => 1, Recurrence_Saturday => 0, Recurrence_Sunday => 0, IncludeLinkedZones => 0 }</li><li>set Sonos_Wohnzimmer Alarm Update 17 { Shuffle => 1 }</li><li>set Sonos_Wohnzimmer Alarm Delete 17 {}</li></ul></li>
|
||||
<li><a name="SONOSPLAYER_setter_DailyIndexRefreshTime">
|
||||
<code>set <name> DailyIndexRefreshTime <time></code></a>
|
||||
<b><code>DailyIndexRefreshTime <time></code></b></a>
|
||||
<br />Setzt die aktuell gültige DailyIndexRefreshTime für alle Zoneplayer.</li>
|
||||
<li><a name="SONOSPLAYER_setter_Name">
|
||||
<code>set <name> Name <Zonename></code></a>
|
||||
<b><code>Name <Zonename></code></b></a>
|
||||
<br />Legt den Namen der Zone fest.</li>
|
||||
<li><a name="SONOSPLAYER_setter_Reboot">
|
||||
<code>set <name> Reboot</code></a>
|
||||
<b><code>Reboot</code></b></a>
|
||||
<br />Führt für den Zoneplayer einen Neustart durch.</li>
|
||||
<li><a name="SONOSPLAYER_setter_RoomIcon">
|
||||
<code>set <name> RoomIcon <Iconname></code></a>
|
||||
<b><code>RoomIcon <Iconname></code></b></a>
|
||||
<br />Legt das Icon für die Zone fest</li>
|
||||
<li><a name="SONOSPLAYER_setter_Wifi">
|
||||
<code>set <name> Wifi <State></code></a>
|
||||
<b><code>Wifi <State></code></b></a>
|
||||
<br />Setzt den WiFi-Zustand des Players. Kann 'off', 'persist-off' oder 'on' sein.</li>
|
||||
</ul></li>
|
||||
<li><b>Abspiel-Steuerbefehle</b><ul>
|
||||
<li><a name="SONOSPLAYER_setter_CurrentTrackPosition">
|
||||
<code>set <name> CurrentTrackPosition <TimePosition></code></a>
|
||||
<b><code>CurrentTrackPosition <TimePosition></code></b></a>
|
||||
<br /> Setzt die Abspielposition innerhalb des Liedes auf den angegebenen Zeitwert (z.B. 0:01:15).</li>
|
||||
<li><a name="SONOSPLAYER_setter_Pause">
|
||||
<code>set <name> Pause</code></a>
|
||||
<b><code>Pause</code></b></a>
|
||||
<br /> Pausiert die Wiedergabe</li>
|
||||
<li><a name="SONOSPLAYER_setter_Previous">
|
||||
<code>set <name> Previous</code></a>
|
||||
<b><code>Previous</code></b></a>
|
||||
<br /> Springt an den Anfang des vorherigen Titels.</li>
|
||||
<li><a name="SONOSPLAYER_setter_Play">
|
||||
<code>set <name> Play</code></a>
|
||||
<b><code>Play</code></b></a>
|
||||
<br /> Startet die Wiedergabe</li>
|
||||
<li><a name="SONOSPLAYER_setter_PlayURI">
|
||||
<code>set <name> PlayURI <songURI> [Volume]</code></a>
|
||||
<b><code>PlayURI <songURI> [Volume]</code></b></a>
|
||||
<br /> Spielt die angegebene MP3-Datei ab. Dabei kann eine Lautstärke optional mit angegeben werden.</li>
|
||||
<li><a name="SONOSPLAYER_setter_PlayURITemp">
|
||||
<code>set <name> PlayURITemp <songURI> [Volume]</code></a>
|
||||
<b><code>PlayURITemp <songURI> [Volume]</code></b></a>
|
||||
<br /> Spielt die angegebene MP3-Datei mit der optionalen Lautstärke als temporäre Wiedergabe ab. Nach dem Abspielen wird der vorhergehende Zustand wiederhergestellt, und läuft an der unterbrochenen Stelle weiter. Wenn die Länge der Datei nicht ermittelt werden kann (z.B. bei Streams), läuft die Wiedergabe genauso wie bei <code>PlayURI</code> ab, es wird also nichts am Ende (wenn es eines geben sollte) wiederhergestellt.</li>
|
||||
<li><a name="SONOSPLAYER_setter_Next">
|
||||
<code>set <name> Next</code></a>
|
||||
<b><code>Next</code></b></a>
|
||||
<br /> Springt an den Anfang des nächsten Titels</li>
|
||||
<li><a name="SONOSPLAYER_setter_Speak">
|
||||
<code>set <name> Speak <Volume> <Language> <Text></code></a>
|
||||
<b><code>Speak <Volume> <Language> <Text></code></b></a>
|
||||
<br /> Verwendet die Google Text-To-Speech-Engine um den angegebenen Text in eine MP3-Datei umzuwandeln und anschließend mittels <code>PlayURITemp</code> als Durchsage abzuspielen. Mögliche Sprachen können auf der Google-Seite nachgesehen werden. Möglich sind z.B. "de", "en", "fr", "es"...</li>
|
||||
<li><a name="SONOSPLAYER_setter_StartFavourite">
|
||||
<code>set <name> StartFavourite <FavouriteName> [NoStart]</code></a>
|
||||
<b><code>StartFavourite <FavouriteName> [NoStart]</code></b></a>
|
||||
<br /> Startet den angegebenen Favoriten. Der Name bezeichnet einen Eintrag in der Sonos-Favoritenliste. Der Parameter sollte/kann URL-Encoded werden um auch Spezialzeichen zu ermöglichen. Wenn das Wort 'NoStart' als zweiter Parameter angegeben wurde, dann wird der Favorit geladen und fertig vorbereitet, aber nicht explizit gestartet.<br />Zusätzlich kann ein regulärer Ausdruck für den Namen verwendet werden. Der erste Treffer wird verwendet. Das Format ist z.B. <code>/meine.hits/</code>.</li>
|
||||
<li><a name="SONOSPLAYER_setter_StartPlaylist">
|
||||
<code>set <name> StartPlaylist <Playlistname> [EmptyQueueBeforeImport]</code></a>
|
||||
<b><code>StartPlaylist <Playlistname> [EmptyQueueBeforeImport]</code></b></a>
|
||||
<br /> Lädt die benannte Playlist und startet sofort die Wiedergabe. Zu den Parametern und Bemerkungen bitte unter "LoadPlaylist" nachsehen.</li>
|
||||
<li><a name="SONOSPLAYER_setter_StartRadio">
|
||||
<code>set <name> StartRadio <Radiostationname></code></a>
|
||||
<b><code>StartRadio <Radiostationname></code></b></a>
|
||||
<br /> Lädt den benannten Radiosender, genauer gesagt, den benannten Radiofavoriten und startet sofort die Wiedergabe. Dabei wird die bestehende Abspielliste beibehalten, aber deaktiviert. Der Parameter kann/muss URL-Encoded sein, um auch Leer- und Sonderzeichen angeben zu können.</li>
|
||||
<li><a name="SONOSPLAYER_setter_Stop">
|
||||
<code>set <name> Stop</code></a>
|
||||
<b><code>Stop</code></b></a>
|
||||
<br /> Stoppt die Wiedergabe</li>
|
||||
<li><a name="SONOSPLAYER_setter_Track">
|
||||
<code>set <name> Track <TrackNumber|Random></code></a>
|
||||
<b><code>Track <TrackNumber|Random></code></b></a>
|
||||
<br /> Aktiviert den angebenen Titel der aktuellen Abspielliste. Wenn als Tracknummer der Wert <code>Random</code> angegeben wird, dann wird eine zufällige Trackposition ausgewählt.</li>
|
||||
</ul></li>
|
||||
<li><b>Einstellungen zum Abspielen</b><ul>
|
||||
<li><a name="SONOSPLAYER_setter_Balance">
|
||||
<code>set <name> Balance <BalanceValue></code></a>
|
||||
<b><code>Balance <BalanceValue></code></b></a>
|
||||
<br /> Setzt die Balance auf den angegebenen Wert. Der Wert kann zwischen -100 (voll links) bis 100 (voll rechts) sein. Gibt die wirklich eingestellte Balance als Ergebnis zurück.</li>
|
||||
<li><a name="SONOSPLAYER_setter_Bass">
|
||||
<code>set <name> Bass <BassValue></code></a>
|
||||
<b><code>Bass <BassValue></code></b></a>
|
||||
<br /> Setzt den Basslevel auf den angegebenen Wert. Der Wert kann zwischen -10 bis 10 sein. Gibt den wirklich eingestellten Basslevel als Ergebnis zurück.</li>
|
||||
<li><a name="SONOSPLAYER_setter_CrossfadeMode">
|
||||
<code>set <name> CrossfadeMode <State></code></a>
|
||||
<b><code>CrossfadeMode <State></code></b></a>
|
||||
<br /> Legt den Zustand des Crossfade-Mode fest. Liefert den aktuell gültigen Crossfade-Mode.</li>
|
||||
<li><a name="SONOSPLAYER_setter_LEDState">
|
||||
<code>set <name> LEDState <State></code></a>
|
||||
<b><code>LEDState <State></code></b></a>
|
||||
<br /> Legt den Zustand der LED fest. Liefert den aktuell gültigen Zustand.</li>
|
||||
<li><a name="SONOSPLAYER_setter_Loudness">
|
||||
<code>set <name> Loudness <State></code></a>
|
||||
<b><code>Loudness <State></code></b></a>
|
||||
<br /> Setzt den angegebenen Loudness-Zustand. Liefert den aktuell gültigen Loudness-Zustand.</li>
|
||||
<li><a name="SONOSPLAYER_setter_Mute">
|
||||
<code>set <name> Mute <State></code></a>
|
||||
<b><code>Mute <State></code></b></a>
|
||||
<br /> Setzt den angegebenen Mute-Zustand. Liefert den aktuell gültigen Mute-Zustand.</li>
|
||||
<li><a name="SONOSPLAYER_setter_MuteT">
|
||||
<code>set <name> MuteT</code></a>
|
||||
<b><code>MuteT</code></b></a>
|
||||
<br /> Schaltet den Zustand des Mute-Zustands um. Liefert den aktuell gültigen Mute-Zustand.</li>
|
||||
<li><a name="SONOSPLAYER_setter_Repeat">
|
||||
<code>set <name> Repeat <State></code></a>
|
||||
<b><code>Repeat <State></code></b></a>
|
||||
<br /> Legt den Zustand des Repeat-Zustands fest. Liefert den aktuell gültigen Repeat-Zustand.</li>
|
||||
<li><a name="SONOSPLAYER_setter_Shuffle">
|
||||
<code>set <name> Shuffle <State></code></a>
|
||||
<b><code>Shuffle <State></code></b></a>
|
||||
<br /> Legt den Zustand des Shuffle-Zustands fest. Liefert den aktuell gültigen Shuffle-Zustand.</li>
|
||||
<li><a name="SONOSPLAYER_setter_SleepTimer">
|
||||
<code>set <name> SleepTimer <Time></code></a>
|
||||
<b><code>SleepTimer <Time></code></b></a>
|
||||
<br /> Legt den aktuellen SleepTimer fest. Der Wert muss ein kompletter Zeitstempel sein (HH:MM:SS). Zum Deaktivieren darf der Zeitstempel nur Nullen enthalten oder das Wort 'off'.</li>
|
||||
<li><a name="SONOSPLAYER_setter_Treble">
|
||||
<code>set <name> Treble <TrebleValue></code></a>
|
||||
<b><code>Treble <TrebleValue></code></b></a>
|
||||
<br /> Setzt den Treblelevel auf den angegebenen Wert. Der Wert kann zwischen -10 bis 10 sein. Gibt den wirklich eingestellten Treblelevel als Ergebnis zurück.</li>
|
||||
<li><a name="SONOSPLAYER_setter_Volume">
|
||||
<code>set <name> Volume <VolumeLevel> [RampType]</code></a>
|
||||
<b><code>Volume <VolumeLevel> [RampType]</code></b></a>
|
||||
<br /> Setzt die aktuelle Lautstärke auf den angegebenen Wert. Der Wert kann ein relativer Wert mittels + oder - Zeichen sein. Liefert den aktuell gültigen Lautstärkewert zurück.<br />Optional kann ein RampType übergeben werden, der einen Wert zwischen 1 und 3 annehmen kann, und verschiedene von Sonos festgelegte Muster beschreibt.</li>
|
||||
<li><a name="SONOSPLAYER_setter_VolumeD">
|
||||
<code>set <name> VolumeD</code></a>
|
||||
<b><code>VolumeD</code></b></a>
|
||||
<br /> Verringert die aktuelle Lautstärke um volumeStep-Einheiten.</li>
|
||||
<li><a name="SONOSPLAYER_setter_VolumeRestore">
|
||||
<code>set <name> VolumeRestore</code></a>
|
||||
<b><code>VolumeRestore</code></b></a>
|
||||
<br /> Stellt die mittels <code>VolumeSave</code> gespeicherte Lautstärke wieder her.</li>
|
||||
<li><a name="SONOSPLAYER_setter_VolumeSave">
|
||||
<code>set <name> VolumeSave <VolumeLevel></code></a>
|
||||
<b><code>VolumeSave <VolumeLevel></code></b></a>
|
||||
<br /> Setzt die aktuelle Lautstärke auf den angegebenen Wert. Der Wert kann ein relativer Wert mittels + oder - Zeichen sein. Liefert den aktuell gültigen Lautstärkewert zurück. Zusätzlich wird der alte Lautstärkewert gespeichert und kann mittels <code>VolumeRestore</code> wiederhergestellt werden.</li>
|
||||
<li><a name="SONOSPLAYER_setter_VolumeU">
|
||||
<code>set <name> VolumeU</code></a>
|
||||
<b><code>VolumeU</code></b></a>
|
||||
<br /> Erhöht die aktuelle Lautstärke um volumeStep-Einheiten.</li>
|
||||
</ul></li>
|
||||
<li><b>Steuerung der aktuellen Abspielliste</b><ul>
|
||||
<li><a name="SONOSPLAYER_setter_AddURIToQueue">
|
||||
<code>set <name> AddURIToQueue <songURI></code></a>
|
||||
<b><code>AddURIToQueue <songURI></code></b></a>
|
||||
<br /> Fügt die angegebene MP3-Datei an der aktuellen Stelle in die Abspielliste ein.</li>
|
||||
<li><a name="SONOSPLAYER_setter_CurrentPlaylist">
|
||||
<code>set <name> CurrentPlaylist</code></a>
|
||||
<b><code>CurrentPlaylist</code></b></a>
|
||||
<br /> Setzt den Abspielmodus auf die aktuelle Abspielliste, startet aber keine Wiedergabe (z.B. nach dem Hören eines Radiostreams, wo die aktuelle Abspielliste noch existiert, aber gerade "nicht verwendet" wird)</li>
|
||||
<li><a name="SONOSPLAYER_setter_EmptyPlaylist">
|
||||
<code>set <name> EmptyPlaylist</code></a>
|
||||
<b><code>EmptyPlaylist</code></b></a>
|
||||
<br /> Leert die aktuelle Abspielliste</li>
|
||||
<li><a name="SONOSPLAYER_setter_LoadPlaylist">
|
||||
<code>set <name> LoadPlaylist <Playlistname> [EmptyQueueBeforeImport]</code></a>
|
||||
<b><code>LoadPlaylist <Playlistname> [EmptyQueueBeforeImport]</code></b></a>
|
||||
<br /> Lädt die angegebene Playlist in die aktuelle Abspielliste. Der Parameter sollte/kann URL-Encoded werden um auch Spezialzeichen zu ermöglichen. Der Playlistname kann auch ein Dateiname sein. Dann muss dieser mit 'file:' beginnen (z.B. 'file:c:/Test.m3u).<br />Wenn der Parameter EmptyQueueBeforeImport mit ''1'' angegeben wirde, wird die aktuelle Abspielliste vor dem Import geleert. Standardmäßig wird hier ''1'' angenommen.<br />Zusätzlich kann ein regulärer Ausdruck für den Namen verwendet werden. Der erste Treffer wird verwendet. Das Format ist z.B. <code>/hits.2014/</code>.</li>
|
||||
<li><a name="SONOSPLAYER_setter_LoadRadio">
|
||||
<code>set <name> LoadRadio <Radiostationname></code></a>
|
||||
<b><code>LoadRadio <Radiostationname></code></b></a>
|
||||
<br /> Startet den angegebenen Radiostream. Der Name bezeichnet einen Sender in der Radiofavoritenliste. Die aktuelle Abspielliste wird nicht verändert. Der Parameter sollte/kann URL-Encoded werden um auch Spezialzeichen zu ermöglichen.<br />Zusätzlich kann ein regulärer Ausdruck für den Namen verwendet werden. Der erste Treffer wird verwendet. Das Format ist z.B. <code>/radio/</code>.</li>
|
||||
<li><a name="SONOSPLAYER_setter_SavePlaylist">
|
||||
<code>set <name> SavePlaylist <Playlistname></code></a>
|
||||
<b><code>SavePlaylist <Playlistname></code></b></a>
|
||||
<br /> Speichert die aktuelle Abspielliste unter dem angegebenen Namen. Eine bestehende Playlist mit diesem Namen wird überschrieben. Der Parameter sollte/kann URL-Encoded werden um auch Spezialzeichen zu ermöglichen. Der Playlistname kann auch ein Dateiname sein. Dann muss dieser mit 'file:' beginnen (z.B. 'file:c:/Test.m3u).</li>
|
||||
</ul></li>
|
||||
<li><b>Gruppenbefehle</b><ul>
|
||||
<li><a name="SONOSPLAYER_setter_AddMember">
|
||||
<code>set <name> AddMember <devicename></code></a>
|
||||
<b><code>AddMember <devicename></code></b></a>
|
||||
<br />Fügt dem Device das übergebene Device als Gruppenmitglied hinzu. Die Wiedergabe des aktuellen Devices bleibt erhalten, und wird auf das angegebene Device mit übertragen.</li>
|
||||
<li><a name="SONOSPLAYER_setter_CreateStereoPair">
|
||||
<code>set <name> CreateStereoPair <rightPlayerDevicename></code></a>
|
||||
<b><code>CreateStereoPair <rightPlayerDevicename></code></b></a>
|
||||
<br />Fügt dem Device das übergebene Device als rechtes Stereopaar-Element hinzu. Die Wiedergabe des aktuellen Devices bleibt erhalten (als linker Lautsprecher), und wird auf das angegebene Device mit übertragen (als rechter Lautsprecher).</li>
|
||||
<li><a name="SONOSPLAYER_setter_GroupMute">
|
||||
<code>set <name> GroupMute <State></code></a>
|
||||
<b><code>GroupMute <State></code></b></a>
|
||||
<br />Setzt den Mute-Zustand für die komplette Gruppe in einem Schritt. Der Wert kann on oder off sein.</li>
|
||||
<li><a name="SONOSPLAYER_setter_GroupVolume">
|
||||
<code>set <name> GroupVolume <VolumeLevel></code></a>
|
||||
<b><code>GroupVolume <VolumeLevel></code></b></a>
|
||||
<br />Setzt die Gruppenlautstärke in der Art des Original-Controllers. Das bedeutet, dass das Lautstärkeverhältnis der Player zueinander beim Anpassen erhalten bleibt.</li>
|
||||
<li><a name="SONOSPLAYER_setter_RemoveMember">
|
||||
<code>set <name> RemoveMember <devicename></code></a>
|
||||
<b><code>RemoveMember <devicename></code></b></a>
|
||||
<br />Entfernt dem Device das übergebene Device, sodass die beiden keine Gruppe mehr bilden. Die Wiedergabe des aktuellen Devices läuft normal weiter. Das abgetrennte Device stoppt seine Wiedergabe, und hat keine aktuelle Abspielliste mehr (seit Sonos Version 4.2 hat der Player wieder die Playliste von vorher aktiv).</li>
|
||||
<li><a name="SONOSPLAYER_setter_SeparateStereoPair">
|
||||
<code>set <name> SeparateStereoPair</code></a>
|
||||
<b><code>SeparateStereoPair</code></b></a>
|
||||
<br />Trennt das Stereopaar wieder auf.</li>
|
||||
<li><a name="SONOSPLAYER_setter_SnapshotGroupVolume">
|
||||
<code>set <name> SnapshotGroupVolume</code></a>
|
||||
<b><code>SnapshotGroupVolume</code></b></a>
|
||||
<br /> Legt das Lautstärkeverhältnis der aktuellen Player der Gruppe für folgende '''GroupVolume'''-Aufrufe fest. Dieses festgelegte Verhältnis wird bis zum nächsten Aufruf von '''SnapshotGroupVolume''' beibehalten.</li>
|
||||
</ul></li>
|
||||
</ul>
|
||||
@ -1352,38 +1380,38 @@ Here an event is defined, where in time of 2 seconds the Mute-Button has to be p
|
||||
<ul>
|
||||
<li><b>Grundsätzliches</b><ul>
|
||||
<li><a name="SONOSPLAYER_getter_Alarm">
|
||||
<code>get <name> Alarm <ID></code></a>
|
||||
<b><code>Alarm <ID></code></b></a>
|
||||
<br /> Ausnahmefall. Diese Get-Anweisung liefert direkt ein Hash zurück, in welchem die Informationen des Alarms mit der gegebenen ID enthalten sind. Es ist die Kurzform für <code>eval(ReadingsVal(<Devicename>, 'Alarmlist', ()))->{<ID>};</code>, damit sich nicht jeder ausdenken muss, wie er jetzt am einfachsten an die Alarm-Informationen rankommen kann.</li>
|
||||
<li><a name="SONOSPLAYER_getter_EthernetPortStatus">
|
||||
<code>get <name> EthernetPortStatus <PortNumber></code></a>
|
||||
<b><code>EthernetPortStatus <PortNumber></code></b></a>
|
||||
<br /> Liefert den Ethernet-Portstatus des gegebenen Ports. Kann 'Active' oder 'Inactive' liefern.</li>
|
||||
<li><a name="SONOSPLAYER_getter_PossibleRoomIcons">
|
||||
<code>get <name> PossibleRoomIcons</code></a>
|
||||
<b><code>PossibleRoomIcons</code></b></a>
|
||||
<br /> Liefert eine Liste aller möglichen RoomIcon-Bezeichnungen zurück.</li>
|
||||
</ul></li>
|
||||
<li><b>Listen</b><ul>
|
||||
<li><a name="SONOSPLAYER_getter_Favourites">
|
||||
<code>get <name> Favourites</code></a>
|
||||
<b><code>Favourites</code></b></a>
|
||||
<br /> Liefert eine Liste mit den Namen aller gespeicherten Sonos-Favoriten. Das Format der Liste ist eine Komma-Separierte Liste, bei der die Namen in doppelten Anführungsstrichen stehen. z.B. "Liste 1","Eintrag 2","Test"</li>
|
||||
<li><a name="SONOSPLAYER_getter_FavouritesWithCovers">
|
||||
<code>get <name> FavouritesWithCovers</code></a>
|
||||
<b><code>FavouritesWithCovers</code></b></a>
|
||||
<br /> Liefert die Stringrepräsentation eines Hash mit den Namen und Covern aller gespeicherten Sonos-Favoriten. Z.B.: {'FV:2/22' => {'Cover' => 'urlzumcover', 'Title' => '1. Favorit'}}. Dieser String kann einfach mit '''eval''' in eine Perl-Datenstruktur umgewandelt werden.</li>
|
||||
<li><a name="SONOSPLAYER_getter_Playlists">
|
||||
<code>get <name> Playlists</code></a>
|
||||
<b><code>Playlists</code></b></a>
|
||||
<br /> Liefert eine Liste mit den Namen aller gespeicherten Playlists. Das Format der Liste ist eine Komma-Separierte Liste, bei der die Namen in doppelten Anführungsstrichen stehen. z.B. "Liste 1","Liste 2","Test"</li>
|
||||
<li><a name="SONOSPLAYER_getter_PlaylistsWithCovers">
|
||||
<code>get <name> PlaylistsWithCovers</code></a>
|
||||
<b><code>PlaylistsWithCovers</code></b></a>
|
||||
<br /> Liefert die Stringrepräsentation eines Hash mit den Namen und Covern aller gespeicherten Sonos-Playlisten. Z.B.: {'SQ:14' => {'Cover' => 'urlzumcover', 'Title' => '1. Playlist'}}. Dieser String kann einfach mit '''eval''' in eine Perl-Datenstruktur umgewandelt werden.</li>
|
||||
<li><a name="SONOSPLAYER_getter_Radios">
|
||||
<code>get <name> Radios</code></a>
|
||||
<b><code>Radios</code></b></a>
|
||||
<br /> Liefert eine Liste mit den Namen aller gespeicherten Radiostationen (Favoriten). Das Format der Liste ist eine Komma-Separierte Liste, bei der die Namen in doppelten Anführungsstrichen stehen. z.B. "Sender 1","Sender 2","Test"</li>
|
||||
<li><a name="SONOSPLAYER_getter_RadiosWithCovers">
|
||||
<code>get <name> RadiosWithCovers</code></a>
|
||||
<b><code>RadiosWithCovers</code></b></a>
|
||||
<br /> Liefert die Stringrepräsentation eines Hash mit den Namen und Covern aller gespeicherten Sonos-Radiofavoriten. Z.B.: {'R:0/0/2' => {'Cover' => 'urlzumcover', 'Title' => '1. Radiosender'}}. Dieser String kann einfach mit '''eval''' in eine Perl-Datenstruktur umgewandelt werden.</li>
|
||||
</ul></li>
|
||||
<li><b>Informationen zum aktuellen Titel</b><ul>
|
||||
<li><a name="SONOSPLAYER_getter_CurrentTrackPosition">
|
||||
<code>get <name> CurrentTrackPosition</code></a>
|
||||
<b><code>CurrentTrackPosition</code></b></a>
|
||||
<br /> Liefert die aktuelle Position innerhalb des Titels.</li>
|
||||
</ul></li>
|
||||
</ul>
|
||||
@ -1393,41 +1421,41 @@ Here an event is defined, where in time of 2 seconds the Mute-Button has to be p
|
||||
'''Hinweis'''<br />Die Attribute werden erst bei einem Neustart von Fhem verwendet, da diese dem SubProzess initial zur Verfügung gestellt werden müssen.
|
||||
<ul>
|
||||
<li><b>Grundsätzliches</b><ul>
|
||||
<li><a name="SONOSPLAYER_attribut_disable"><code>attr <name> disable <int></code>
|
||||
<li><a name="SONOSPLAYER_attribut_disable"><b><code>disable <int></code></b>
|
||||
</a><br /> One of (0,1). Deaktiviert die Event-Verarbeitung für diesen Zoneplayer.</li>
|
||||
<li><a name="SONOSPLAYER_attribut_generateSomethingChangedEvent"><code>attr <name> generateSomethingChangedEvent <int></code>
|
||||
<li><a name="SONOSPLAYER_attribut_generateSomethingChangedEvent"><b><code>generateSomethingChangedEvent <int></code></b>
|
||||
</a><br /> One of (0,1). 1 wenn ein 'SomethingChanged'-Event erzeugt werden soll. Dieses Event wird immer dann erzeugt, wenn sich irgendein Wert ändert. Dies ist nützlich, wenn man immer informiert werden möchte, egal, was sich geändert hat.</li>
|
||||
<li><a name="SONOSPLAYER_attribut_generateVolumeEvent"><code>attr <name> generateVolumeEvent <int></code>
|
||||
<li><a name="SONOSPLAYER_attribut_generateVolumeEvent"><b><code>generateVolumeEvent <int></code></b>
|
||||
</a><br /> One of (0,1). Aktiviert die Generierung eines Events bei Lautstärkeänderungen, wenn minVolume oder maxVolume definiert sind.</li>
|
||||
<li><a name="SONOSPLAYER_attribut_generateVolumeSlider"><code>attr <name> generateVolumeSlider <int></code>
|
||||
<li><a name="SONOSPLAYER_attribut_generateVolumeSlider"><b><code>generateVolumeSlider <int></code></b>
|
||||
</a><br /> One of (0,1). Aktiviert einen Slider für die Lautstärkekontrolle in der Detailansicht.</li>
|
||||
<li><a name="SONOSPLAYER_attribut_getAlarms"><code>attr <name> getAlarms <int></code>
|
||||
<li><a name="SONOSPLAYER_attribut_getAlarms"><b><code>getAlarms <int></code></b>
|
||||
</a><br /> One of (0..1). Richtet eine Callback-Methode für Alarme ein. Damit wird auch die DailyIndexRefreshTime automatisch aktualisiert.</li>
|
||||
<li><a name="SONOSPLAYER_attribut_volumeStep"><code>attr <name> volumeStep <int></code>
|
||||
<li><a name="SONOSPLAYER_attribut_volumeStep"><b><code>volumeStep <int></code></b>
|
||||
</a><br /> One of (0..100). Definiert die Schrittweite für die Aufrufe von <code>VolumeU</code> und <code>VolumeD</code>.</li>
|
||||
</ul></li>
|
||||
<li><b>Informationen generieren</b><ul>
|
||||
<li><a name="SONOSPLAYER_attribut_generateInfoSummarize1"><code>attr <name> generateInfoSummarize1 <string></code>
|
||||
<li><a name="SONOSPLAYER_attribut_generateInfoSummarize1"><b><code>generateInfoSummarize1 <string></code></b>
|
||||
</a><br /> Erzeugt das Reading 'InfoSummarize1' mit dem angegebenen Format. Mehr Informationen dazu im Bereich Beispiele.</li>
|
||||
<li><a name="SONOSPLAYER_attribut_generateInfoSummarize2"><code>attr <name> generateInfoSummarize2 <string></code>
|
||||
<li><a name="SONOSPLAYER_attribut_generateInfoSummarize2"><b><code>generateInfoSummarize2 <string></code></b>
|
||||
</a><br /> Erzeugt das Reading 'InfoSummarize2' mit dem angegebenen Format. Mehr Informationen dazu im Bereich Beispiele.</li>
|
||||
<li><a name="SONOSPLAYER_attribut_generateInfoSummarize3"><code>attr <name> generateInfoSummarize3 <string></code>
|
||||
<li><a name="SONOSPLAYER_attribut_generateInfoSummarize3"><b><code>generateInfoSummarize3 <string></code></b>
|
||||
</a><br /> Erzeugt das Reading 'InfoSummarize3' mit dem angegebenen Format. Mehr Informationen dazu im Bereich Beispiele.</li>
|
||||
<li><a name="SONOSPLAYER_attribut_generateInfoSummarize4"><code>attr <name> generateInfoSummarize4 <string></code>
|
||||
<li><a name="SONOSPLAYER_attribut_generateInfoSummarize4"><b><code>generateInfoSummarize4 <string></code></b>
|
||||
</a><br /> Erzeugt das Reading 'InfoSummarize4' mit dem angegebenen Format. Mehr Informationen dazu im Bereich Beispiele.</li>
|
||||
<li><a name="SONOSPLAYER_attribut_stateVariable"><code>attr <name> stateVariable <string></code>
|
||||
<li><a name="SONOSPLAYER_attribut_stateVariable"><b><code>stateVariable <string></code></b>
|
||||
</a><br /> One of (TransportState,NumberOfTracks,Track,TrackURI,TrackDuration,Title,Artist,Album,OriginalTrackNumber,AlbumArtist,<br />Sender,SenderCurrent,SenderInfo,StreamAudio,NormalAudio,AlbumArtURI,nextTrackDuration,nextTrackURI,nextAlbumArtURI,<br />nextTitle,nextArtist,nextAlbum,nextAlbumArtist,nextOriginalTrackNumber,Volume,Mute,Shuffle,Repeat,CrossfadeMode,Balance,<br />HeadphoneConnected,SleepTimer,Presence,RoomName,SaveRoomName,PlayerType,Location,SoftwareRevision,SerialNum,InfoSummarize1,I<br />nfoSummarize2,InfoSummarize3,InfoSummarize4). Gibt an, welche Variable in das Reading <code>state</code> kopiert werden soll.</li>
|
||||
</ul></li>
|
||||
<li><b>Steueroptionen</b><ul>
|
||||
<li><a name="SONOSPLAYER_attribut_maxVolume"><code>attr <name> maxVolume <int></code>
|
||||
<li><a name="SONOSPLAYER_attribut_maxVolume"><b><code>maxVolume <int></code></b>
|
||||
</a><br /> One of (0..100). Definiert die maximale Lautstärke dieses Zoneplayer.</li>
|
||||
<li><a name="SONOSPLAYER_attribut_minVolume"><code>attr <name> minVolume <int></code>
|
||||
<li><a name="SONOSPLAYER_attribut_minVolume"><b><code>minVolume <int></code></b>
|
||||
</a><br /> One of (0..100). Definiert die minimale Lautstärke dieses Zoneplayer.</li>
|
||||
<li><a name="SONOSPLAYER_attribut_maxVolumeHeadphone"><code>attr <name> maxVolumeHeadphone <int></code>
|
||||
<li><a name="SONOSPLAYER_attribut_maxVolumeHeadphone"><b><code>maxVolumeHeadphone <int></code></b>
|
||||
</a><br /> One of (0..100). Definiert die maximale Lautstärke dieses Zoneplayer im Kopfhörerbetrieb.</li>
|
||||
<li><a name="SONOSPLAYER_attribut_minVolumeHeadphone"><code>attr <name> minVolumeHeadphone <int></code>
|
||||
<li><a name="SONOSPLAYER_attribut_minVolumeHeadphone"><b><code>minVolumeHeadphone <int></code></b>
|
||||
</a><br /> One of (0..100). Definiert die minimale Lautstärke dieses Zoneplayer im Kopfhörerbetrieb.</li>
|
||||
<li><a name="SONOSPLAYER_attribut_buttonEvents"><code>attr <name> buttonEvents <Time:Pattern>[ <Time:Pattern> ...]</code>
|
||||
<li><a name="SONOSPLAYER_attribut_buttonEvents"><b><code>buttonEvents <Time:Pattern>[ <Time:Pattern> ...]</code></b>
|
||||
</a><br /> Definiert, dass bei einer bestimten Tastenfolge am Player ein Event erzeugt werden soll. Die Definition der Events erfolgt als Tupel: Der erste Teil vor dem Doppelpunkt ist die Zeit in Sekunden, die berücksichtigt werden soll, der zweite Teil hinter dem Doppelpunkt definiert die Abfolge der Buttons, die für dieses Event notwendig sind.<br />
|
||||
Folgende Button-Kürzel sind zulässig: <ul><li><b>M</b>: Der Mute-Button</li><li><b>H</b>: Die Headphone-Buchse</li><li><b>U</b>: Up-Button (Lautstärke Hoch)</li><li><b>D</b>: Down-Button (Lautstärke Runter)</li></ul><br />
|
||||
Das Event, das geworfen wird, heißt <code>ButtonEvent</code>, der Wert ist die definierte Tastenfolge<br />
|
||||
@ -1435,7 +1463,6 @@ Z.B.: <code>2:MM</code><br />
|
||||
Hier wird definiert, dass ein Event erzeugt werden soll, wenn innerhalb von 2 Sekunden zweimal die Mute-Taste gedrückt wurde. Das damit erzeugte Event hat dann den Namen <code>ButtonEvent</code>, und den Wert <code>MM</code>.</li>
|
||||
</ul></li>
|
||||
</ul>
|
||||
<br />
|
||||
<a name="SONOSPLAYERexamples"></a>
|
||||
<h4>Beispiele / Hinweise</h4>
|
||||
<ul>
|
||||
|
||||
Loading…
x
Reference in New Issue
Block a user