1 Introduction

1.1 Overview

This guide explains how to play an alert sound with SAFR Actions based on some event criteria such as person of type threat detected.

This document assumes you have prepared your SAFR system for matching faces and generating the events of interest. For example, you may have configured SAFR on one or more cameras to identify persons from a watchlist and generate an action when a person from the Watchlist is matched. If needed, refer to SAFR Documentation at http://docs.real.com for more information on setting up.

This document also assumes you are familiar with SAFR Actions, how to create SAFR Actions configuration files, where to place SAFR Actions scripts and how to troubleshoot SAFR Actions. For more information about SAFR Actions, see “Running a Script with SAFR Actions.

1.2 Required Hardware and Software

1.2.1 Required Hardware

  • A PC to run SAFR Actions. This PC should operate 24x7 to monitor for new events.
    • If using SAFR On-Premises server, then SAFR Actions is installed with SAFR Platform installer and can be run on the same machine as SAFR Server.
    • If using SAFR Cloud, then a separate PC is required to run SAFR Actions.

1.2.2 System Requirements

Following are the minimum system requirement to run SAFR Actions

  • Intel i5 CPU or equivalent
  • 8 GB RAM
  • 100 GB HD

1.2.3 Required Software

SAFR Actions is installed with SAFR Desktop or SAFR Server. Only run SAFR Actions on a single PC or actions will be duplicated.

1.3 Required Files

Following batch file is used in this guide to play a sound with SAFR Actions. This file should be downloaded and placed in SAFR Actions scripts directory as described below.

2 Install the Batch File in Scripts Directory

To generate a system sound, use the file provided above under Required Files described below.

  1. Download systemsounds.bat using the link above.
  2. Remove any security restrictions on the file such as below under File Properties:
    A close up of a text AI-generated content may be incorrect.
  3. Save the file to C:\Program Files\SAFR\RealNetworks\ares\scripts

3 Solution Setup

3.1 Prepare SAFR Actions Config

Prepare the SAFR Actions config file for playing a sound as described below.

  1. Open SAFR Actions
  1. Use the “+” and “-“ symbols to add and remove properties to match the screenshot below.
  • Clicking "-" deletes that row or entire section
  • Clicking "+" adds a row following current row
  • Some items such as "idClass" allow for one or more items. After adding the property, click "+" to add each item.

A screenshot of a computer AI-generated content may be incorrect.

  1. Select File > Save to reload the new configuration.
  2. Check SAFR Actions log file to ensure there are no errors
    1. Open C:\ProgramData\RealNetworks\SAFR\ares\logs\ares.log
    2. Check that the last line of the file is as follows:

Ares v3.3.033 started!
Listening for events...

3.2 Stop SAFR Actions Windows Service and Run as Command Line

  1. Open Windows Services control panel and scroll to SAFR Ares
  2. Stop the SAFR Ares service and configure its Startup Type to Manual as follows:

A screenshot of a computer AI-generated content may be incorrect.

  1. Start SAFR Actions command line as shown below

cd "C:\Program Files\RealNetworks\SAFR"
jdk\bin\java.exe -jar ares\ares.jar ares\SAFRActions.config

  1. SAFR Actions should start up and show the following output on the command line:

Ares v3.3.033 started!
Listening for events...

  1. Set idClass as “Threat” for a known person record
  2. Have that person appear in front of camera to trigger an event of type Threat
  3. You should hear the computer where this script is running play a sound.
  4. Once verified, set up a Windows Scheduled Task as described below to automatically run this command in the background.

3.3 Running SAFR Actions in Windows Scheduled Task

  1. Open “Windows Scheduler” and create a new Task.
  1. Under General give a name and set following settings so task runs in background:

Go to “Triggers” and click “New…” and create an “At Log on” trigger as follows:

A screenshot of a computer AI-generated content may be incorrect.

Go to “Actions” and create a command Action as follows:

A screenshot of a computer AI-generated content may be incorrect.

Go to Settings tab and configure as follows:

Once created, manually start the new Task. Normally the task will start at Windows boot time.

If the configuration is changed, Start and Stop the Task in order to reload the new configuration.