Skip to main content

BriefCam VMS Integration Guide

Axis Integration

Last Updated: 2 minute read
LanguageEnglish

Integration Summary

VMS Partner 

Product 

Version 

Last Tested BriefCam Version 

Integration Level 

H.265 Support 

Axis 

Axis ACS 

6.3

2024 R2 HF4

Real time alerts integration (L2a)

No

Axis 

Axis ACS 

6.16

2025 R1 SP1

Real time alerts integration (L2a)

Yes

Axis 

Axis ACS 

5.33

6.4 Hot Fix 1

Real time alerts integration (L2a)

No

Note that the name of the plugin is: BriefcamACSPlugin_[version number].exe.

Ports Required

The following port should be available when installing the plugin.

Axis Version 

Port # 

Axis ACS v5.X

55756

Axis ACS v6.X

29204

For Axis ACS v6.X:

  1. Open the BriefCam.ACSIntegration.ini file, which is located by default at: C:\Program Files\BriefCam\BriefCam Server\plugins.

  2. Change the DefaultPort parameter to 29204 and uncomment the row.

Axis DefaultPort.PNG

Sending Alerts to Axis

Alerts can be sent to Axis ACS. To enable this functionality, carry out the steps below.

BriefCam Configuration 

In the Environment Settings section, there are three settings relevant for sending alerts outside of BriefCam (see the image below):

  1. To send alerts outside of BriefCam, set the Respond.AlertsPublishingEnabled setting to true.

  2. To send alerts to a VMS, check that the Respond.AlertsPublishingToVMSEnabled setting is set to true.

  3. To change the polling interval, use the Respond.AlertsPublishingIntervalInMilliseconds setting.

    SendAlertssettings.png

  4. If you make changes to the settings, you need to restart or start the VSServer service.

Axis Configuration 

On the Axis side you need a full admin user.

  1. On the ACS server (incoming):

    1. For Axis ACS v5.X, open UDP port 55756.

    2. For Axis ACS v6.X, open UDP port 29204.

  2. To configure the VMS side’s trigger, go to the Axis Camera System's Configuration tab, open the Recording and events folder and then the Action rules option.

  3. Click New.

    Axis 6 Action rules.png

  4. Add a new trigger by clicking Add.

    Axis 6 Add trigger.PNG

  5. Select External HTTPS and click OK.

    Axis 6 External HTTPS.PNG

  6. Enter a trigger name. This name will be used in the json mapping file, described below.

    Axis 6 Trigger name.PNG

  7. Click OK and then click Next.

  8. Add an action.

    Axis 6 Add action.PNG

  9. Select the required action (usually Raise Alarm) and click OK.

    Axis 6 Raise alarm.PNG

  10. Fill in the alarm’s Title and Descriptionfields. This information will be shown to the operator once the alert is triggered.

    Axis 6 Alarm message.PNG

  11. Open the AxisCamerasMap.json file, located at: C:\Program Files\BriefCam\BriefCam Server\plugins. This file maps between the cameras and the alarms. Note that this file must always be in the same folder as the plugin’s dll file.

  12. In the AxisCameraMap.json file, enter the Trigger Name from step 6.

  13. Raise the trigger by filling in either the CameraId with the External ID from ACS or by entering the Respond Rule Name.

    Axis ini.png

  14. Repeat for any rules that you need.

Known Limitations

  • Bounding boxes when playing the original video are not supported.

  • Due to a limitation with the Axis API, no data can be sent to Axis ACS.