Changes between Version 25 and Version 26 of WikiStart

Timestamp:

2013-03-06 14:57:36 (11 years ago)

Author:

lolodomo

Comment:

--

WikiStart

@@ -107 +107 @@
 {{{
 luup.call_action("urn:micasaverde-com:serviceId:Sonos1", "Say",
-                 {Text="Welcome Home", Language="en", Volume=50, Devices="667,668"},
+                 {Text="Welcome Home", Language="en", Volume=50, GroupDevices="667,668"},
                  666)
 }}}
 
+This action will pause the current playback, say the text, and then the playback will be resumed.
+
+By using the !GroupDevices parameter, it is even possible to activate the Text To Speech on several Sonos zones at the same time. This parameter represents a CSV list of deviceId's of other Sonos units that should be included during the save-say-restore model of the Say command.
+
 Notes:
  * This service may be removed at any time, as can happen with Google services.
- * Parameters not specified will default internally. (''Language=en'', ''Devices=""'', ''Volume=50'')
+ * Parameters not specified will default internally. (''Language=en'', ''!GroupDevices=""'', ''Volume=nil'') By default, the volume is not set.
+
+
+=== Making a Sonos play an alert message ===
+This functionality is exposed declaratively through the ''Alert'' action under Advanced Scenes.
+The functionality is also exposed programmatically via Lua code:
+{{{
+luup.call_action("urn:micasaverde-com:serviceId:Sonos1", "Alert",
+                 {URI="x-file-cifs:...", Volume=50, Duration=15, GroupDevices="667,668"},
+                 666)
+}}}
+
+This action will pause the current playback, play the alert, and then the playback will be resumed.
+
+By using the !GroupDevices parameter, it is even possible to play the alert on several Sonos zones at the same time. This parameter represents a CSV list of deviceId's of other Sonos units that should be included during the save-play-restore model of the Alert command.
+
+Notes:
+ * Parameters not specified will default internally. (''Duration=10'', ''!GroupDevices=""'', ''Volume=nil'') By default, the volume is not set.