*selectCamera
- Tom Polman
Configuration Article | CA-20220907-TP-34 VDG Sense | API | Functions | Layouts  |  |
Note: This function requires an API license.
Selects a camera. The camera is displayed in the panel which is identified by panelid in the layout which is identified by layoutid. The system (set of servers and viewers) searches all viewers to find the place where the layout is displayed. Use parameter cameraview to define the camera, this includes the serverid and deviceid. If divaid is given, the command will only by send to the system with that id.
The use of panelindex is deprecated. This value only counts panels which are used for displaying video. Other panels are skipped. I.e. if there are 4 panels of which the second panel is an event panel and panelindex = 2, the fourth panel (with panelindex 3) is used. Note that panelid and panelindex cannot be used simultaneously. The use of panelindex is deprecated. Use panelid instead.
Request
command=selectCamera&cameraview=[camview]&layoutid=[UID]&panelid=[UID]&panelindex=[0..]&divaid=[UID] |
parameter | type | remarks |
|---|---|---|
cameraview | [camview] | Camera view |
layoutid | [UID] | unique layout id |
panelid | [UID] | panel id |
panelindex | [0..] | panel index |
divaid | [UID] | unique id |
keeppanelselection | [boolean] | true or false to keep current panel selected |
Response
error code | description | remarks |
|---|---|---|
0 | Ok | Ok, no error |
-2 | No device | No device found for the supplied cameraid/deviceid |
-14 | No Layout | No layout found for the supplied layoutid |
-18 | General error | An undefined error occured |
Changelog
2.3.18 – Added panelid
2.3.1 – Added divaid
2.1.2 – Fixed dispatching to viewers, and using serverid
1.11.1 – CameraView extended with left, top, righ and bottom parameters
1.10.1 – Added