Get camera events using WebSocket

Axxon Next 4.3.0.8031 and higher versions.

To get the camera events using WebSocket, do the following:

Connect to ws://[user_name]:[password]@[IP-address]:[port]/[prefix]/events.
Send a JSON command to subscribe on events generated by the specified cameras (see Get list of video sources (cameras)). This subscription allows you to receive all the events shown in the table below.
```
{
"include":
["hosts/Server1/DeviceIpint.1/SourceEndpoint.video:0:0", "hosts/Server1/DeviceIpint.6/SourceEndpoint.video:0:0"],
"exclude":[]
}
```
include - subscribe to the events receiving;
exclude - disable the events receiving.

The response will contain the following JSON:

   {
    objecs: [
    {type: "devicestatechanged", name: "hosts/Server1/DeviceIpint.1", state: "signal restored"}
    ]
    }

List of event types and camera states:

Event type	Description	States
devicestatechanged	Camera state	signal restored - connected, signal restored signal lost - signal lost
alert	Alarm	No states
alert_state	Alarm state	processing - the alarm is being processed closed - alarm processed reaction - alarm initiated
detector_event	Detection tool triggering	No states
camera_record_state	Archive record state	on - the camera is recording to the archive off - the camera is not linked to the archive gray - the camera is linked to the archive, but is not recording

Note

If the camera is disabled in Axxon Next, no events are received from it using WebSocket, including the signal lost event.

Example of message:

objects: [{name: "hosts/Server1/DeviceIpint.1/SourceEndpoint.video:0:0", state: "signal restored",…},…]
0: {name: "hosts/Server1/DeviceIpint.1/SourceEndpoint.video:0:0", state: "signal restored",…}
name: "hosts/Server1/DeviceIpint.1/SourceEndpoint.video:0:0"
state: "signal restored"
type: "devicestatechanged"

Page tree

Documentation for Axxon Next 4.5.0 - 4.5.10. Documentation for other versions of Axxon Next is available too.