|
| |
 |
VisorAPI
Application
Programming Interface for VisorNET applications development
|
 |
General
Overview
VisorNet API provides mechanisms via three modules (ActiveX) in order to
interact with the VisorNet equipment for an application developer for Windows
platform. All of the functionality offered by these modules is found in a
VisorNet Remote Video Monitoring Center's (from this point on Telesurveillance
Station Server) applications. The operations are enumerated below and divided
into modules and orientation.
ActiveX
VisorEngine
- System Access Group. Operations orientated towards the access
control and the connection of the operators to the Telesurveillance Station
Server.
- Information group for Operators and System Centers. Operations
orientated towards obtaining information from the remote centers.
- Information group for Areas and Related Devices. Operations
orientated towards obtaining information on the defined areas for remote
centers.
- Information Group for Customers and Services. Operations orientated
towards obtaining information on the Customers in the System and the offered
Services.
ActiveX
ViewEngine
- Local Queries Group for the Telesurveillance Station Server.
Operations orientated towards the querying of saved recordings in the
Telesurveillance Station Server.
- Remote Queries Group for the Recordings Servers. Operations
orientated to the querying of the remote recordings hosts. Permits the
possibility to download recordings in the Telesurveillance Station Server.
- System Access Group. Operations orientated to the access control
and the connection of the operators in the Telesurveillance Station Server.
ActiveX
WatchEngine
- Telesurveillance Group. Operations orientated towards viewing the
cameras from the equipment.
- Alarms Management Group.Operations orientated to alarms handling
and validation by the operators.
- Control group for Serial Ports and MatrixesOperations orientated to
the remote control of device serial ports and the matrixes connected to
these.
- Mobile Camera Control Group. Operations orientated to the control
of the mobile cameras connected to the equipment. See the Appendix on the External
Modules for Mobile Cameras and Matrixes Control.
- Management Group for Input and Output devices.Operations orientated
towards the control of the input and output devices, i.e. device activation
and deactivation
- System Access Group.Operations orientated towards the access
control and connection of the operators to the Telesurveillance Station
Server
Log
mode
Information about log mode in the API can be found in
Log Mode
Changes
in version 6.0.0
Changes from previous versions in the API can be found in Changes
Telesurveillance
Station Server Software Architecture.
The VisorNet Telesurveillance Station Server is planned on a local area network
(LAN). You have a Center Server, various Center Operators and communications
devices (gateways, for example routers, modems, bridges, etc.), in order to
connect with the VisorNet equipment through a wide area network (WAN). This can
be ISDN (Integrated Services Digital Network), Frame Relay, PSTN (Public
Switching Telephone Network) or the LAN itself.
The system database is found in the Server. This receives the alarms together
with their recordings from the VisorNet equipment and stores them. The Server is
the storage location for the downloaded recordings from the remote recordings
hosts and is also the system input point for the operators. The server
integrates various services in order to carry out these operations:
- Alarms Reception Service The TCP/IP service is dedicated to the
reception and storage of alarms originating from the remote devices. This is
listening on port 80.
- Database Maintenance and Recordings Volumes Service This is a
service dedicated to the maintenance of the system database, i.e. the
elimination of expired alarms and recordings, freeing space due to the
occupation limit in the volumes of saved recordings.
- System Access Service This is the TCP/IP service dedicated to the
reception of operators to the System. This is listening on port 30005.
The server can also carry out operator functions.
- Attention:
- VNetAPI does not provide modules for the construction of an independent
Telesurveillance Station Server. The server for Telesurveillance is unique
and is provided by Teldat. Any developer that wishes to use their structure
and functionality should install this and configure it using the software
provided by Teldat for this purpose.
The Operator has a series of modules available over which he/she carries out all
their operations through the Telesurveillance Station Server. These operations
are:
- Telesurveillance Station Server Configuration Operations
- Telesurveillance Operations
- Alarm Management Operations
- Recordings Query Operations
- Network Monitoring Operations
Consult the reference guide VisorNet4_OperatorManual for further details on all
of these operations. In order to have a Remote Video Monitoring Center Server,
it is necessary to install the software provided by Teldat with the
ServerSetup.exe installation program. The operator software provided by Teldat
with the Setup.exe installation program is needed in order to configure this.
- Attention:
- As you have seen, server services are constructed over TCP/IP
protocols, and use determined IP ports shown in the following table. No
other application should use this range of IP ports. Video and alarm
reception implies using TCP ports.
| Source |
Destination |
Protocol/Port |
Utilization |
| PC |
VisorNet |
TCP/80 |
Video reception and every command between operator and VisorNet or
Recording Server |
| VisorNet |
PC |
TCP/80 |
Video alarms reception |
|