selectCamera

Selects a camera.

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 (What is DIVA?).

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 (What is DIVA?)
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

See Also

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