The cameras used by the HS/FS are managed in this mask. Cameras can, for example, be used for surveillance of the entrance area of a house. Camera images can be saved in the camera archive of the HS/FS, and stored externally via E-mail or FTP.
The display of the camera image of the camera takes place in the camera mask in the Query menu and in the visualisation. In the visualisation, there is also the possibility to position the camera image in the visualisation area. The camera image cannot be displayed in the WAP display.
To create a new network camera,
The display of the camera image of the camera takes place in the camera mask in the Query menu and in the visualisation. In the visualisation, there is also the possibility to position the camera image in the visualisation area. The camera image cannot be displayed in the WAP display.
To create a new network camera,
- switch to the "Camera" window.
- Move the mouse pointer in the directory tree to "Camera".
- Press the right mouse button. A pull-down menu opens.
- Select "Create camera" and fill out the fields in the screen mask that opens.
Cameras can be imported and exported via the Global Library.
Important
Please note that the HS/FS only supports network cameras and not "web cams" at the USB port!
1.Tabs
1.1.Data
Designation
Designation of the camera in the project.
Cameras can be searched via the end point interface, where a word from the designation begins with the search word used there.
Cameras can be searched via the end point interface, where a word from the designation begins with the search word used there.
IP address of the camera
Numeric IP address or name of the camera through which the HS/FS can reach the camera.
If a DNS (Domain Name Server) is available, a name can be entered.
If a DNS (Domain Name Server) is available, a name can be entered.
IP port of the camera
This option is activated if the IP port should be changed (for example, if the call should be made via HTTPS).
If this option is not activated, the camera is addressed via the standard IP port 80.
If this option is not activated, the camera is addressed via the standard IP port 80.
Camera image path
The image in the camera is retrieved via this path. Examples are listed below.
Timeout (in sec.)
The HS/FS waits to receive an image when the time period set here is called up.
If the time period is exceeded and no image is received, a white space appears in the screen display.
If the time period is exceeded and no image is received, a white space appears in the screen display.
Protocol
There are network cameras that use different procedures for retrieving images. The HS/FS makes two different procedures available:
- via HTTP
The camera returns an image via HTTP protocol. - via HTTPS
The camera must be addressed via HTTPS and the correspondingly configured HTTPS port.
The cameras listed in the examples use the first procedure.
The procedure has no effect on the archiving of camera images. Both procedures are suitable.
The procedure has no effect on the archiving of camera images. Both procedures are suitable.
Image height and image width (in pixels)
Specification of the standard size of the image in pixels for further processing in the visualisation.
Parameters can be assigned for image widths and heights.
This does NOT determine the size of the image retrieved from the camera. This is determined by the URL in the "path for camera image".
Parameters can be assigned for image widths and heights.
This does NOT determine the size of the image retrieved from the camera. This is determined by the URL in the "path for camera image".
Streamable
The continual retrieval of individual images can be activated using this option.
A moving image can be shown when using the client program.
To relieve the HS/FS, we recommend activating Direct access to the camera in user management.
A moving image can be shown when using the client program.
To relieve the HS/FS, we recommend activating Direct access to the camera in user management.
Waiting time (in milliseconds)
In streaming operation, the individual images are retrieved within the specified interval. The minimum waiting time is 200 ms. Shorter times are not possible.
Password protection
Yes: The HS/FS logs on to the camera with the Standard basic authentication procedure, provided that image retrieval is protected by a user name and password.
If the camera has password protection and Direct access was activated in the user management of the HS/FS, the user must log on again to the camera when accessing via the browser.
If the camera has password protection and Direct access was activated in the user management of the HS/FS, the user must log on again to the camera when accessing via the browser.
1.2.End point
Cameras, more precisely the current camera image, can be accessed via the end point interface of the HS/FS.
There is a description of the call parameters here.
There is a description of the call parameters here.
Note
Any camera can be used of course instead of the camera used in all the call-up examples in the following table.
Placeholders are specified in UPPER CASE.
Placeholders are specified in UPPER CASE.
1.2.1.Methods
| Method | Description/Call |
|---|---|
| meta | Retrieval of metadata from the camera.https://HS_IP/endpoints/call?key=CP@my_cam&method=meta&user=USER&pw=PWD |
| get_picture | Retrieval of the current image (as JSON, base64-coded) from a camera.https://HS_IP/endpoints/call?key=CP@my_cam&method=get_picture&user=USER&pw=PWD |
| get_picture_raw | Retrieval of the current image (as binary blob, e.g., as JPEG) from a camera.https://HS_IP/endpoints/call?key=CP@my_cam&method=get_picture_raw&user=USER&pw=PWD |
1.2.2.Fields
ID
The value entered here forms the unique object keyof the end point, together with the fixed prefix "CP", with which the ID is connected by an '@' character.
Permitted characters are: A-Z, a-z, 0-9, hyphen ("-") and underscore ("_")!
Permitted characters are: A-Z, a-z, 0-9, hyphen ("-") and underscore ("_")!
Description
A meaningful description of the camera.
Cameras can be searched via the end point interface, where a word from the description begins with the search word used there.
Cameras can be searched via the end point interface, where a word from the description begins with the search word used there.
Tags
A list of terms, separated by commas (",").
Cameras can be searched via the end point interface, where an individual tag completely matches the search word used there.
Permitted characters are: A-Z, a-z, 0-9, hyphen ("-") and underscore ("_")!
Cameras can be searched via the end point interface, where an individual tag completely matches the search word used there.
Permitted characters are: A-Z, a-z, 0-9, hyphen ("-") and underscore ("_")!
User groups
Important
This item is only available when user groups have been activated!
User groups can be authorised to access this camera via the end point interface.
1.3.E-mail
All parameters for sending a camera image per e-mail are set here. Different variants can be put together in the list. The list is created, deleted, and changed using the operating buttons to the right of the list.
Note
This option is only available after sending via e-mail has been activated beforehand via Master data\Project\Network\E-mail.
1.4.FTP
All parameters for sending a camera image via FTP (file transfer protocol) are set here. Different variants can be put together in the list. The elements can be created, deleted, or changed using the operating buttons to the right of the list.
Note
This option is only available after support has been activated beforehand via Master data\Project\Network\FTP.
2.Examples of call parameters
There follows a list of paths, image names and parameters for retrieving a camera image. Check the camera documentation to ensure that the specified entries are also correct for your model/firmware. Text the validity of the entry in your browser. The path should send an image of the camera without menu etc.
No liability shall be accepted for the following entries!
AXIS
See current camera documentation.
Mobotix network cameras
The path /record/current.jpg supplies the standard image set in the camera's menu.
In older firmware versions, the path /cgi-bin/image.jpg could also be used.
No liability shall be accepted for the following entries!
AXIS
See current camera documentation.
Mobotix network cameras
The path /record/current.jpg supplies the standard image set in the camera's menu.
In older firmware versions, the path /cgi-bin/image.jpg could also be used.