Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Note
titleImportant!

Disable the Use device settings checkbox in order to change the manage parameters by the below commands – see The Settings panel of the Video Capture Device capture device object.

A camera must support the same commands for features management as the given ECHD commands (both when connected via ONVIF and via the corresponding driver).

...

ParameterIs requiredDescription
1YesID of video surveillance device.
2NoIP addressof video surveillance device.
3Noaccount of video surveillance device.
4Noaccess password to video surveillance device.
5Yes

Command name:

degreesmove – discrete motion. Atomic shift of video surveillance device in the specified direction. 

degreesmove2 – relative motion. 

Rotation of video surveillance device compared with current position. Viewing area of video surveillance device is divided by a grid where central point’s coordinates are (x:0, y:0), top left (x:-7, y:7), bottom right (x:7, y:-7). Video surveillance device must be rotated in a way that object appears in the center of the grid.

‘Optical’ error caused by the distance to the visible object is allowed.

Error caused by sphere-to-plane projection must be compensated.

Depending on camera, registry keys may have to be set for correct operation:

  1. Thecamera does not support Point&Click but supports absolute PTZ. Set the ReplacePointAndClick registry key to 1 (see Registry keys reference guide).
  2. Thecamera supports Point&Click. Set the ReplacePointAndClick registry key to 0 and TelemetryCommandMoveTimeout to delay in milliseconds between panning/tilting and zooming (see Registry keys reference guide).

setposition – setting position of video surveillance device in degrees compared with ‘0’ position.

getposition – getting position of video surveillance device inpAN and TILt in degrees as well as current zoom values.

focus – video surveillance device’s focus control command where z parameter controls over focus:

1: Focus in

-1 : Focus out

0: Auto

iris – video surveillance device’s iris control command where z parameter controls over iris:

1: Open iris

-1: Close iris

0: Auto

switch_day_night – switch day/night mode where z parameter enables one of the following modes:

1: Day mode

-1 : Night mode

backlight – switch backlight on/off where z parameter controls over the mode:

1: Enable

-1: Disable

switch_color – the following operation modes of video surveillance device are set by z parameter:

1: Enable

-1: Disable

6No

In degreesmove, setposition commands: PAN rotation [-180 ..0.. 180].

In degreesmove2: PAN rotation [-7..0..7].

In getposition: not in use.

In commands focus, iris, switch_day_night, backlight, switch_color: set value 0 to the parameter.

7No

In degreesmove, setposition commands: TILT rotation [-180 ..0.. 180].

In degreesmove2: TILT rotation [-7..0..7].

In getposition: not in use.

In commands focus, iris, switch_day_night, backlight, switch_color: set value 0 to the parameter.

8No

In degreesmove, degreesmove2, setposition commands: zoom in/out [0.. 100].

In getposition: not in use.

In commands focus, iris, switch_day_night, backlight, switch_color: set device mode, see description of the corresponding command above.

9NoModel of video surveillance device.

Request example:

GET http://127.0.0.1:80/execute?cameraID=7&action=getposition

...