Visitor Announcement

This solution guide describes how to set up a visitor announcement system which will send a notification message to a receptionist or sales assistant when a registered person arrives at the entrance of your office.

This guide is written for Windows users. Linux users can achieve the same functionality, but they need to use the Web Console instead of the Desktop Client & SAFR Actions GUI.

For simplicity’s sake, this guide assumes that you’re using a SAFR Cloud License. If you’re using a SAFR On-Premise License, you’ll also need to install and manage the SAFR Server.

Required Hardware and Software

Required Hardware

Required Software

Install SAFR Desktop Client and SAFR Actions

Download and install the SAFR Desktop installer for Windows from the SAFR Download Portal. The SAFR Desktop installer includes both the SAFR Desktop Client and SAFR Actions. Note that when you install SAFR Actions, both of the following are installed:

If you have many cameras, you may need to install multiple Desktop Clients on different machines. Typically each machine can handle up to 8 cameras. If you do install multiple Desktop Clients, don’t install ARES (or SAFR Actions) on the additional clients; you should only install one ARES instance.

Camera Selection

Cameras should be located so that subjects’ faces aren’t backlit; the faces should be well lit from the front with an even and uniform lighting. Direct sunlight on faces should also be avoided in order to reduce sharp contrast, which often hides facial features.

A 1080p USB camera such as the Logitech C920 HD Webcam 1080p Webcam is good enough for this use case. A table top IP camera such as Hikvision DS-2CD2442FWD-IW would also work fine.

Install and Connect your Cameras

For each camera you install, do the following:

  1. Within the SAFR Desktop Client’s Camera Feed Analyzer window (i.e. the client’s default window), select the camera you want to install.
  2. Select the Enrolled and Stranger Monitoring video processing mode from the drop-down menu in the upper right corner of the Camera Feed Analyzer window.
  3. Optimize the camera location and orientation. Adjust the camera’s optical zoom to ensure that subjects’ faces are at least 80 pixels high from chin to forehead.
  4. Adjust the focus of the camera to the closest position where all subjects’ faces are within the camera’s field of view. (i.e. ensure that no one will be to the left or right of the camera view)
  5. Add the camera’s video feed to your Video Recognition Gateway (VIRGO) video feeds by pressing the Add to Video Feeds button.
  6. Check your system’s CPU and GPU load. If you need to install an additional camera, but doing so would increase your CPU or GPU load to 100% or greater, install an additional instance of the SAFR Desktop Client on a different machine and install the additional camera on the newly installed Desktop Client.

Configure SAFR to Send Notifications

Configure SAFR to Send Emails

Configure SAFR so that it can use an email server to send email messages.

  1. Get an SMTP Server account you can use for sending emails.
  2. Within the SAFR Actions GUI, select Configure Email Server… from the Tools drop down menu at the top.
  3. You’ll be prompted to enter your SAFR credentials.
  4. You’ll be presented with the following dialogue. Fill out all the fields of the dialogue.
    • Sender Email: The email username of the SMTP account. (e.g. Susan.Johnson@gmail.com)
    • Email Password: The password for the SMTP account.
    • Sender Name: The display name on the “From” line. (e.g. Susan Johnson)
    • From Email Address: The email address that will appear on the “From” line. This feature isn’t supported by all email servers; if this field isn’t used then the Sender Email value is used for the “From” line.
    • Email Server Address: The address of the SMTP email server.
    • Server Port: The email server port. The default port for SMTP is 587.
  5. Click Apply.

Configure SAFR to Send SMS Messages

Configure SAFR so that it can use a short message service (SMS) server to send SMS messages.

  1. Set up an AWS account. Make sure your AWS account is configured for your region so that it can send SMS messages.
  2. Within the SAFR Actions GUI, select Configure SMS Sender… from the Tools drop down menu at the top.
  3. You’ll be prompted to enter your SAFR credentials.
  4. You’ll be presented with the following dialogue. Fill out all the fields of the dialogue.
    • SMS Provider: The SMS provider that you’re using. This value will always be Amazon_SNS.
    • Access Key: Your Amazon SNS Access Key.
    • Secret Key: Your Amazon SNS Secret Key.
    • Region: The region of your Amazon SNS.
    • Sender Id: The name that will be used to send the SMS messages.
    • Send Test Message: Configure the test message that will be sent after you finish setting up SMS.
      • Phone Number: The phone number to which the test message will be sent. It should be in the E.164 format. (e.g. +2065551313)
      • Message: The text message that will be sent to the phone number specified above.
  5. Click Apply, then click Send

Configure ARES

Note: Make sure the SAFR Actions GUI is not running during steps 1-3 below.

On the machine where ARES is installed:

  1. Delete the default SAFRActions.config file located at C:\ProgramData\RealNetworks\SAFR\ares\config.
  2. Save VisitorSAFRActions.config to C:\ProgramData\RealNetworks\SAFR\ares\config.
  3. Rename the config file you just saved to SAFRActions.config.
  4. Start the SAFR Actions GUI.
  5. Within the SAFR Actions GUI, set the following fields to the specified values:
    • userId: Your username.
    • userPwd: Your password.
    • emailDef -> Item 1 -> recipients -> Item 1: The email address of whomever you want to receive email notifications. If you want more than 1 person to receive email notifications, do the following:
      1. Hover your mouse over recipients.
      2. Press the + button to create additional recipients.
      3. Set the newly created item(s) to the additional email address(es).
    • emailDef -> Item 2 -> recipients -> Item 1: The email address of whomever you want to receive email notifications. If you want more than 1 person to receive email notifications, do the following:
      1. Hover your mouse over recipients.
      2. Press the + button to create additional recipients.
      3. Set the newly created item(s) to the additional email address(es).
    • smsDef -> Item 1 -> recipients -> Item 1: The phone number of whomever you want to receive SMS notifications. It should be in the E.164 format. (e.g. +2065551313) If you want more than 1 person to receive SMS notifications, do the following:
      1. Hover your mouse over recipients.
      2. Press the + button to create additional recipients.
      3. Set the newly created item(s) to the additional phone number(s).
    • smsDef -> Item 2 -> recipients -> Item 1: The phone number of whomever you want to receive SMS notifications. It should be in the E.164 format. (e.g. +2065551313) If you want more than 1 person to receive SMS notifications, do the following:
      1. Hover your mouse over recipients.
      2. Press the + button to create additional recipients.
      3. Set the newly created item(s) to the additional phone number(s).
  6. Choose File > Save to save your changes.

Note: If ARES is installed on a different machine from a SAFR Desktop Client, make sure the system clocks on the Desktop Client and ARES machines are within a few seconds of each other. (If the two system clocks differ by more than a few seconds, events may not trigger.)

Test Your Visitor Announcement System

To test the “StrangerDetected” notifications of the system that you have just set up, do the following:

  1. Open the SAFR Actions GUI and make sure that your email address and phone number are listed as recipients of the “StrangerDetected” email and SMS notifications, as described in the Configure ARES section above.
  2. Hide your face from all connected cameras.
  3. Show your face to a connected camera and wait for SAFR to recognize you.
  4. Upon recognition, you should see the following:
    • You should receive a “StrangerDetected” email notification in your inbox.
    • Your phone should receive a “StrangerDetected” SMS message.

To test the “RegisteredDetected” notifications, do the following:

  1. Register yourself into SAFR.
  2. Open the SAFR Actions GUI and make sure that your email address and phone number are listed as recipients of the “RegisteredDetected” email and SMS notifications, as described in the Configure ARES section above.
  3. Hide your face from all connected cameras.
  4. Show your face to a connected camera and wait for SAFR to recognize you.
  5. Upon recognition, you should see the following:
    • You should receive a “RegisteredDetected” email notification in your inbox.
    • Your phone should receive a “RegisteredDetected” SMS message.

Downloadable Files