How to Configure SPS-A100M Audio Beacon API Command for Audio Files

Applies to: SPS-A100M

Summary

This article describes how to configure Hanwha SPS-A100M Audio Beacon to load and, via API command, play pre-recorded messages.

Uploading Audio Files

To upload audio files:

1. Log in to the Audio Beacon Web interface.
   
   
2. Select Settings > Video and Audio > Audio Setup.
   
   
   
   
3. Scroll to the Audio Clip section, and click Upload.
   
   
4. Select desired audio clips (.wav and .mp3 supported).
   
   
5. Click Apply.
   

   NOTE: Currently, the file name can contain no special characters 
   or spaces (to be corrected in upcoming firmware release). There 
   is a 6MB limit reserved for total of all audio clips, and up to 
   5 files can be uploaded. 

API Script

Upon completion of file uploads, the files are recognized in the SUNAPI API as Index numbers (1-5) in the top-to-bottom order they appear in the list. The API script format is in HTTP/HTTPS format and as follows:

http://<IP-ADDRESS>/stw-cgi/eventrules.cgi?msubmenu=audiooutfiles&action=control&Index=1&Type=Play

In the script, replace <IP ADDRESS> with the address of the Audio Beacon. The Index number is the number (1-5) of the file to be played.

To test this command, copy/paste into a web browser.

Using the API Command in WAVE

To create an HTTP(S) command in WAVE:

1. Log in to WAVE.
   
   
2. Select the device from the menu.
   
   
3. Navigate to System Administration > Event Rules > Add new rule.
   
   In the example, a soft trigger is created on a camera:
   
   
   
   When: Soft Trigger
   At: Select the camera
   Name: Name the Event
   Icon: Select icon to be displayed on the camera
   Action: Do HTTP(S) request
   Interval: Select interval of time event is not to repeat
   HTTP(S) URL: Paste the script
   Login/PW: Credentials of the Audio Beacon
   
   

4. Click Apply.
   
   

5. Open the camera and engage the soft trigger to test.