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 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).

General request format:

GET https://IP-address:port/?cameraID={1}&ip={2}&loqin={3}&pass={4}&action={5}&x={6}&y={7}&z={8}&modelName={9}

Request parameters:

ParameterIs requiredDescription
1YesID of video surveillance device.
2NoIP address of video surveillance device.
3No account 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. The camera does not support Point&Click but supports absolute PTZ. Set the ReplacePointAndClick registry key to 1 (see Registry keys reference guide).
  2. The camera 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 in pAN 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

Response example:

Response comes on getposition command only. Example in JSON format:

{"y":56, "x":105, "z":0}

Response parameters:

ParameterDescription
xPAN coordinate
yTILT coordinate
zZoom value