Go to documentation repository
Important!
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:
| Parameter | Is required | Description |
|---|---|---|
| 1 | Yes | ID of video surveillance device. |
| 2 | No | IP address of video surveillance device. |
| 3 | No | account of video surveillance device. |
| 4 | No | access password to video surveillance device. |
| 5 | Yes | 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:
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 |
| 6 | No | 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. |
| 7 | No | 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. |
| 8 | No | 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. |
| 9 | No | Model 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:
| Parameter | Description |
|---|---|
| x | PAN coordinate |
| y | TILT coordinate |
| z | Zoom value |
Overview
Content Tools