Webhooks – Exacq

Description

Axis networked speaker(s) are individually capable of having pre-recorded audio clips loaded onto them for playback. Audio effects such as door bells, barking dogs, event announcements, and more may be desired for a given site.

Models C1410 / C2005

Playback of audio files from the network speaker(s) cannot be triggered through exacqVision Client or Server.

Whether or not the networked IP speaker is added to the exacqVision server as a licensed device, an operator may trigger various audio clips for playback through the device’s web browser interface or by using a REST endpoint for the device.

The REST endpoint cannot be triggered via exacqVision webhooks.

exacqVision webhooks are currently only capable of issuing ‘POST’ requests, but Axis networked speakers require a ‘GET’ request, as well as authentication to the device.

As a result the current workarounds are suggested:

Trigger playback using API commands through a web browser.
Trigger playback using API commands in your CLI.
Write your own intermediary HTTP listener that accepts ‘POST’ requests from exacqVision webhooks and issues it’s own ‘GET’ requests to your device.

The above suggestions are for advanced users and assistance via Exacq’s Support team is not provided.

Model C1310-E

The C1310-E Network Horn Speaker provides a workaround to native plugin audio playback or the use of webhooks, mentioned above. The following steps detail how to configure a Digital Output and trigger audio clip playback through exacqVision. This method has been tested with Axis firmware 11.4.63 using exacqVision Server and Client 23.03.

Log into the web interface of the C1310-E. Expand the System menu, then select Events.
From the Rules tab, select ‘Add a rule.’
Using the Add rule dialog pop-up, provide a descriptive name for the rule. In our example we wish to trigger the built-in ‘Ding Dong’ audio clip, so simply name it ‘Ding Dong.’
Complete the rest of the dialog options as seen in the picture below. Select ‘Digital output is active’ from the Condition drop-down menu and select the ‘Use this condition as a trigger’ checkbox.

From the Action section, select ‘Play audio clip,’ then choose your selected audio clip from the Clip drop-down menu. Optionally, make any changes to the Repeat or Volume fields. Click ‘Save’ when done.
Within your exacqVision Desktop Client, enter Configuration mode, then navigate to the Event Linking setup page by clicking the Event Linking node from the tree on the left.
Along the bottom of the page, click the New button to create a new Event Linkage.
In this example we will choose to create a Soft Trigger to manually trigger the audio playback, but you can just as easily choose another option to trigger playback. Refer to our User Training Videos for more on configuring Event Linking.

From the Event Type menu, we select ‘Soft Trigger’, then click New under Event Source to create and name a new Soft Trigger.
Next, select the newly created Soft Trigger from the Event Source list.
Select ‘Output Trigger’ from the Action Type list. You will not have the option of renaming the trigger from the device, but you will note that the C1310-E shows an Output 1 listed as a possible Action Target. Select this option as your Action Target.
Click ‘Apply’ from the bottom of the page to save your changes.
Returning to Live mode in the client, click the ‘Soft Trigger’ menu icon from the toolbar above.
From the Soft Trigger menu, you may trigger the audio playback by toggling your newly created soft trigger into Alarm state.

NOTE: The Axis firmware currently only allows one output trigger to be created at a time, therefore it is only possible to choose one audio clip for playback. Although, you may create many different Event Links to trigger the audio clip to play regardless of the source event it will play the same clip. See workaround methods above for the C1410 and C2005 if this presents an issue.