A trigger server event can be sent to a player to interrupt playback and begin playing a specific piece of predetermined content by placing a web customized web address in any browser.  A real-life example of this would be to send an weather alert, perhaps flash flooding in a particular area. Normal content playback could be interrupted, and a warning for the flash flood area would take over the screen display. This would be done by an administrator at a location by placing a custom web address into a browser. 

Let's take a look at the steps to create this type of programming and custom web URL.  Use these links to get started: Creating a ProgramHow to Create a Screen Layout for a Program

Here are the steps for setting up that type of alert trigger programming.

1. Create a program and apply a layout,  in this example we have a simple one zone full screen layout and add some content, in this case four jpgs and the alert jpg (flash flood warning)

2. Add two "jump to track"commands before and after the alert content.  Edit both jump-to-tracks to target track 1 of the program. The reasoning is, that content should not play unless told other wise, so the first jump to will send it back to the beginning of the loop, and the second is for when the alert message has played in full duration, it will resume playback to track 1.  Edit these commands by clicking the gray gear and choosing 1 as the target track. Refer to the Adding a Jump to Track Command solution.

3. Adding the event - click the lightning bolt seen at the top of the program editor.  Click add an event, the green plus sign and choose server event. Next go to the column on the right, while the server event is selected and add another "jump to track" command. Edit that command, by making the location of the alert jpg the target track, seen as track 6.

4. Click the paper and pencil icon to the right.  Select the arguments as seen below, and choose an appropriate trigger word, as seen here "flood".  Click Update and OK.

5.  Set up the player's site settings to have the proper API settings as seen below. Select (Port 9900) save and republish the site settings.

6. Set up a user for the account with the role of "client admin" within the management tab. (NOTE: The user must be created within the account where you are creating the trigger program. A VAR network wide master username and password will NOT work)

 Click the green plus sign to create a new user. Fill out the fields and create the client admin. Refer to the Adding Full Access Admin Users solution.

6. Apply the details to the URL coding to trigger the alert jpg from any browser using this formula:   http://varapi.enqii.net/engage/ws/player/sendEvent?playerIDs[]=player_id_here&networkID=network_id_here&eventID=14&eventJSON={"eventIdentifier":"trigger_word_here"}&username=client_admin_username_here&password=client_admin_password_here

  • For the player ID: 2520 scroll of the player blue question mark for these ids.

  • Network ID:  scroll over the site blue question mark for these ids.

  • Insert the trigger word, which we selected in the server event section of the program - "flood"
  • Insert the username and password of the user with the proper credentials "client admin"

Once this information is plugged into the custom URL. past it into a browser and hit enter.  This will trigger the flood alert to play. Once is is entered into the browser, it should say "true" and work perfectly as seen below.