diff --git a/doc/PTZ.xml b/doc/PTZ.xml
index c018403d6..2cb1bf869 100644
--- a/doc/PTZ.xml
+++ b/doc/PTZ.xml
@@ -412,6 +412,10 @@ Add GeoMove
MaximumNumberOfPresetTours – Indicates number of preset tours that can be created. Required preset tour operations shall be available for this PTZ node if one or more preset tours are supported.
+
+ MaxRecordedTours - Indicates the maximum number of recorded tours that can be
+ created.
+
@@ -1726,13 +1730,23 @@ Add GeoMove
- Preset Tour Operations
- Preset tour is a feature for PTZ-capable devices, enabling the PTZ unit to move on specified presets sequentially at some interval.
- This section describes operations that manage the preset tours. These operations shall be implemented when a PTZ node in the PTZ service indicates support of preset tours with MaximumNumberOfPresetTours>0 capability value, All operations require a profile token referencing a Media Profile including a PTZConfiguration. All operations for preset tours shall always be persistent.
- PresetTours can have forward and backward directions, and in case direction is omitted, it is assumed to be forward. However, it is possible to specify random execution by setting the RandomPresetOrder attribute. In case RandomPresetOrder is set to true and Direction is also present, Direction will be ignored and presets of the Tour will be recalled randomly.
+ Tour Operations
+ Tours are a feature for PTZ-capable devices, enabling the PTZ unit to move sequentially
+ on a set of presets or a recorded tour. This section describes operations to manage and
+ operate tours.
+ All operations require a profile token referencing a Media Profile including a
+ PTZConfiguration. Tour configurations shall be persistent.
+ Preset tours can have forward and backward directions, and in case direction is omitted,
+ it is assumed to be forward. However, it is possible to specify random execution by setting
+ the RandomPresetOrder attribute. In case RandomPresetOrder is set to true and Direction is
+ also present, Direction will be ignored and presets of the Tour will be recalled
+ randomly.
+ A device signaling support for operation mode Record shall support recording of
+ tours.
GetPresetTours
- A device supporting Preset Tour feature shall return all available preset tours through GetPresetTours.
+ A device with PTZ node signaling support for SupportedPresetTour or MaxRecordedTours
+ shall support this command to return all tours of a PTZ node.
request
@@ -1767,7 +1781,8 @@ Add GeoMove
GetPresetTour
- A device supporting preset tours shall return the requested preset tour through GetPresetTour.
+ A device with PTZ node signaling support for SupportedPresetTour or MaxRecordedTours
+ shall support this command to return the configuration of the requested tour.
request
@@ -1806,7 +1821,9 @@ Add GeoMove
GetPresetTourOptions
- A device supporting preset tours shall provide options for how preset tours can be configured through GetPresetTourOptions.
+ A device with PTZ node signaling SupportedPresetTour shall support this command and
+ provide options for how preset tours can be configured through
+ GetPresetTourOptions.
request
@@ -1843,7 +1860,9 @@ Add GeoMove
CreatePresetTour
- A device supporting Preset Tour feature shall allow creating a new Preset Tour through the CreatePresetTour.
+ Create an empty preset tour to be filled via ModifyPresetTour. A device signaling
+ support via its PTZ node field MaximumNumberOfPresetTours shall support this
+ command.
request
@@ -1878,9 +1897,54 @@ Add GeoMove
+
+ RecordTour
+ Create a recorded tour or overwrite an existing tour. Finish the recording with tour
+ operation stop. A tour can be deleted with RemovePresetTour.
+ A device signaling support for recorded tours via the capability MaxRecordedTours
+ shall support this command.
+
+
+ request
+
+ ProfileToken [tt:ReferenceToken]
+ Reference to an existing media profile.
+ TourToken - optional [tt:ReferenceToken]
+ If provided an existing tour will be overwritten instead of creating a new one.
+
+
+
+ response
+
+ TourToken [tt:ReferenceToken]
+ Reference to the newly created tour.
+
+
+
+ faults
+
+ env:Sender - ter:InvalidArgVal - ter:NoProfile
+ The requested profile token ProfileToken does not exist.
+ env:Sender - ter:InvalidArgVal - ter:NoPTZProfile
+ The requested profile token does not reference a PTZ configuration.
+ env:Sender - ter:InvalidArgVal - ter:TooManyRecordedTours
+ The limit of MaxRecordedTours has been reached and no further
+ recorded tours can be created for the requested PTZ node.
+
+
+
+ access class
+
+ ACTUATE
+
+
+
+
ModifyPresetTour
- A device supporting preset tours shall allow modifying a preset tour through ModifyPresetTour.
+ A device signaling support for preset tours via the PTZ node parameter
+ MaximumNumberOfPresetTours shall support modifying a preset tour through
+ ModifyPresetTour.
request
@@ -1924,20 +1988,23 @@ Add GeoMove
OperatePresetTour
- A device supporting preset tours shall allow starting, stopping, or pausing a preset tour through OperatePresetTour.
+ A device supporting preset tours shall allow starting, stopping, or pausing a preset
+ tour as signaled by the PTZ node configuration.
Preset tour can be operated with the PresetTourOperation parameter of OperatePresetTour command.
- Start: indicates starting the preset tour or re-starting the paused preset tour.
+ Start: indicates starting the tour or re-starting the paused preset tour.
- Stop: indicates stopping the preset tour.
+ Stop: indicates stopping a tour or a recording.
- Pause:iIndicates pausing the preset tour.
+ Pause: indicates pausing the preset tour.
When receiving another OperatePresetTour command of Start operation for a preset tour which has already been started, the preset tour shall be restarted with the newly requested parameter.
+ A PTZ node that signals support for recorded tours via its MaxRecordedTours field
+ shall support the Record operation.
request
@@ -1946,8 +2013,8 @@ Add GeoMove
Reference to an existing media profile.
PresetTourToken [tt:PTZPresetTourToken]
Reference to an existing preset tour.
- Operation [tt:PTZPresetTourOperation]
- Operation information.
+ Operation [xs:string]
+ Operation as define by tt:PTZTourOperation.
@@ -1981,7 +2048,8 @@ Add GeoMove
RemovePresetTour
- A device supporting preset tours shall support removing preset tours through RemoevPresetTour.
+ A device supporting tours shall support removing preset and recorded tours through
+ RemovePresetTour.
request
@@ -2083,7 +2151,8 @@ Add GeoMove
- PresetTourDirection: A device refers this flag to choose which direction the preset tour goes. It is omissible parameter and Forward shall be chosen in case it is omitted. [Optional]
+ PresetTourDirection: Optional list of supported operation direction. Defaults
+ to forward only.
Forward: Preset tour goes in forward order.
@@ -2095,6 +2164,10 @@ Add GeoMove
+
+ IsRecorded: The preset tour has been recorded instead of being defined by a set of
+ presets.
+
Token: Unique identifier of the preset tour
diff --git a/wsdl/ver10/schema/onvif.xsd b/wsdl/ver10/schema/onvif.xsd
index b3df64207..70451eddf 100755
--- a/wsdl/ver10/schema/onvif.xsd
+++ b/wsdl/ver10/schema/onvif.xsd
@@ -4162,6 +4162,13 @@ decoding .A decoder shall decode every data it receives (according to its capabi
+
+
+
+ Indicates the maximum number of different tours that can be recorded.
+
+
+
@@ -4196,7 +4203,7 @@ decoding .A decoder shall decode every data it receives (according to its capabi
- Indicates which preset tour operations are available for this PTZ Node.
+ List of operations provided for preset tours.
@@ -4763,6 +4770,11 @@ decoding .A decoder shall decode every data it receives (according to its capabi
Unique identifier of this preset tour.
+
+
+ Signal that this tour has been recorded and may have an empty list of tour spots.
+
+
@@ -4973,7 +4985,7 @@ decoding .A decoder shall decode every data it receives (according to its capabi
- Supported options for Direction of Preset Tour.
+ Supported direction of Preset Tour. Defaults to forward.
diff --git a/wsdl/ver20/ptz/wsdl/ptz.wsdl b/wsdl/ver20/ptz/wsdl/ptz.wsdl
index 7d01747ae..ff8fae7c3 100644
--- a/wsdl/ver20/ptz/wsdl/ptz.wsdl
+++ b/wsdl/ver20/ptz/wsdl/ptz.wsdl
@@ -634,6 +634,26 @@ IN NO EVENT WILL THE CORPORATION OR ITS MEMBERS OR THEIR AFFILIATES BE LIABLE FO
+
+
+
+
+
+
+ Optional tour to be overwritten. By default create a new tour.
+
+
+
+
+
+
+
+
+
+
+
+
+
@@ -896,6 +916,12 @@ IN NO EVENT WILL THE CORPORATION OR ITS MEMBERS OR THEIR AFFILIATES BE LIABLE FO
+
+
+
+
+
+
@@ -1146,6 +1172,11 @@ If no stop argument for pan, tilt or zoom is set, the device will stop all ongoi
+
+ Start recording of a new recorded tour or start overwriting an existing tour.
+
+
+
Operation to modify a preset tour for the selected media profile.
@@ -1399,6 +1430,15 @@ If no stop argument for pan, tilt or zoom is set, the device will stop all ongoi
+
+
+
+
+
+
+
+
+