ISAPI_2.0-PTZ Service.pdf

1

2014-07

2

Content

1 Introduction ...................................................................................................................... 4

2 Conformance ................................................................................................................... 4

3 Glossary and Relationship ............................................................................................ 4

3.1 Glossary of Terms ............................................................................................................. 4

3.2 Basic PTZ space type XML .............................................................................................. 5

4 PTZ Service and Resources ......................................................................................... 5

4.1 PTZCtrl ............................................................................................................................. 5

4.2 /ISAPI/PTZCtrl/capabilities .............................................................................................. 6

4.3 /ISAPI/ PTZCtrl/channels ................................................................................................. 6

4.10 /ISAPI/PTZCtrl/channels/<ID>/relative ......................................................................... 12

4.11 /ISAPI/PTZCtrl/channels/<ID>/absolute ........................................................................ 12

4.12 /ISAPI/PTZCtrl/channels/<ID>/digital ........................................................................... 13

4.13 /ISAPI/PTZCtrl/channels/<ID>/status ............................................................................ 13

4.14 /ISAPI/PTZCtrl/channels/<ID>/presets .......................................................................... 14

4.15 /ISAPI/PTZCtrl/channels/<ID>/presets/<ID> ................................................................ 15

4.16 /ISAPI/PTZCtrl/channels/<ID>/presets/<ID>/goto ........................................................ 16

4.17 /ISAPI/PTZCtrl/channels/<ID>/patrols .......................................................................... 16

4.18 /ISAPI/PTZCtrl/channels/<ID>/patrols/<ID> ................................................................. 17

4.19 /ISAPI/PTZCtrl/channels/<ID>/patrols/<ID>/start ......................................................... 18

4.23 /ISAPI/PTZCtrl/channels/<ID>/patrols/<ID>/schedule .................................................. 19

4.24 /ISAPI/PTZCtrl/channels/<ID>/patterns ......................................................................... 19

4.25 /ISAPI/PTZCtrl/channels/<ID>/patterns/<ID> ............................................................... 20

4.26 /ISAPI/PTZCtrl/channels/<ID>/patterns/<ID>/recordstart ............................................. 21

4.27 /ISAPI/PTZCtrl/channels/<ID>/patterns/<ID>/recordstop ............................................. 21

4.28 /ISAPI/PTZCtrl/channels/<ID>/patterns/<ID>/start ....................................................... 21

4.36 /ISAPI/PTZCtrl/channels/<ID>/ptzlimiteds/<ID>/stop .................................................. 25

3

4.37 /ISAPI/PTZCtrl/channels/<ID>/saveptzpoweroff ........................................................... 26

4.38 /ISAPI/PTZCtrl/channels/<ID>/timetasks ...................................................................... 26

4.39 /ISAPI/PTZCtrl/channels/<ID>/timetasks/<ID> ............................................................ 27

4.40 /ISAPI/PTZCtrl/channels/<ID>/timetasks/<ID>/copytask ............................................. 28

4.41 /ISAPI/PTZCtrl/channels/<ID>/auxcontrols ................................................................... 29

4.42 /ISAPI/PTZCtrl/channels/<ID>/auxcontrols/<ID> ......................................................... 29

4.43 /ISAPI/PTZCtrl/channels/<ID>/onepushfoucs/start ....................................................... 30

4.44 /ISAPI/PTZCtrl/channels/<ID>/onepushfoucs/reset ....................................................... 31

4.45 /ISAPI/PTZCtrl/channels/<ID>/ManualTrace ................................................................ 31

4.46 /ISAPI/PTZCtrl/channels/<ID>/position3D.................................................................... 31

4.47 /ISAPI/PTZCtrl/channels/<ID>/autoPan ........................................................................ 32

4

1 Introduction

This specification mainly introduces the PTZ function section of ISAPI Protocol.

2 Conformance

All of interface definition in this specification is consistent with that of ISAPI protocol,

the specification is a part of ISAPI protocol. The architecture, glossary and relationship

are consistent with ISAPI IPMD documentation.

3 Glossary and Relationship

• PTZ channel = PTZ channel is the basic unit of PTZ functions, and a

PTZ channel corresponds to a PTZ control unit.

• Continuous PTZ = PTZ control unit that supports to configure PTZ

control speed, the parameter is speed of PTZ.

• Momentary Move = this part is the extension of Continuous PTZ

function. The running time can be specified in the command and PTZ

movement will stop when reaching the specified time.

• Preset Point =Moving to a position can be marked as a preset, the preset

includes the following parameters: horizontal direction, vertical direction and

lens distance,.etc.

• Patrol = Patrol is a collection of a serials of preset points; the path of

patrol will be in order of presets.

5

The definition of PTZ space: “X” represents the horizontal direction; “Y” represents

the vertical direction, “Z” on behalf of lens distance. A few basic variables will be

introduced in this section.