Changes between Version 48 and Version 49 of WikiStart

Timestamp:

2014-10-18 13:54:06 (10 years ago)

Author:

lolodomo

Comment:

--

WikiStart

@@ -219 +219 @@
 
 
-=== Making a Sonos play an alert message (outdated) ===
+=== 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.
+                 {URI="x-file-cifs:...", Duration=15},
+                 666)
+}}}
+
+If Duration parameter is set to a greater value than 0, this action will pause the current playback, play the alert, and the previous playback will be resumed when the delay defined by Duration expires.
+If Duration parameter is unset or set to 0, this action will pause the current playback, play the alert, but then the previous playback will not be resumed.
+
+You can use the optional parameters Volume, !SameVolumeForAll, !GroupZones and !GroupDevices. The usage is exactly the same as for the Say action.
 
 Notes:
- * Parameters not specified will default internally. (''Duration=10'', ''!GroupDevices=""'', ''Volume=nil'') By default, the volume is not set.
+ * For URI parameter, you can use the same syntax as for the !URIToPlay parameter of the action !PlayURI
+ * For !GroupZones, you have to use room names (zone names defined with your Sonos application), not the name of your Vera device
+ * It is possible to use the parameter named !GroupDevices in place of !GroupZones. In this case, you must have a device in the Vera for all the Sonos zones you want to address. The value is a CSV list of device ids. For example, if your living-room and kitchen Sonos are linked respectively to devices 667 and 668 in your Vera, you will use !GroupDevices="667,668". The !GroupDevices has been kept for compatibility reasons with old versions but the use of !GroupZones is now recommended.
+ * Parameters not specified will default internally. (''Duration=0'', ''!GroupDevices=""'', ''!GroupZones=""'', ''Volume=nil'', ''!SameVolumeForAll=false'') By default, the volume is not set.