An event consists of two parts; a trigger and an action. When the trigger occurs, the action is performed. Actions include displaying a web page, playing another sequence, collecting data (such as an email address), or adding advanced data.
A trigger can occur at any time while the item is displaying and the action will interrupt the playback of the active item.
Click the New event button on the Events tab of the Library item dialog, Stack item dialog, Sequence dialog, or Screen dialog to display the Configure event dialog. Use this dialog to define a trigger and an action to be performed. A trigger can occur at any time while the item is displaying and the action will interrupt the playback of the active item.
The following options are available:
Trigger
- Touch — Select to trigger the playback action only when an item/screen is touched.
- Keypress — Select to trigger the playback action only when a specified key is pressed. Specify the key (0-9, A-Z) in the Key dropdown list.
- Barcode — Select to trigger the playback action only when a barcode matches the specified pattern. Enter the barcode pattern in the Pattern field, or leave blank to trigger on every scan. When the action is to display a web page, add ~barcode to the web page address to pass the barcode through to a web service.
- NFC tag — Select to trigger the playback action only when an NFC tag matches the specified pattern. Enter the NFC tag pattern in the Pattern field, or leave blank to trigger on every scan. When the action is to display a web page, add ~nfcTagText to the web page address to pass the barcode through to a web service.
- RS232 input — Select to trigger the playback action only when RS232 input matches the specified pattern. Enter the RS232 input pattern in the Pattern field.
- Condition — Select to trigger the playback action only when specified conditions are met. Enter conditions directly into the Condition field or click Build new condition to display the Build new condition dialog which provides options to help you build conditions based on Location, Audience analytics, Scheduling, and Frequency.
Note: Be careful not to create conditional triggers that continuously fire and interrupt regular playback. Conditional triggers should only evaluate to True briefly and should go out of scope as a result of the action.
- Remote API call — Select to trigger the playback action with a web request from another device. This option allows independent systems to be linked. For example an alarm system could be configured to make an API call to trigger the action.
Action
In the top dropdown list, select the playback action. The options available on the dialog change depending on what you select.
Show item — When selected and the trigger occurs, you can choose a single item, a sequence, or multiple items to be displayed when the trigger is met.
- Single item — Choose a library item, link to a web page, or link to streaming media.
- Inner sequence — Select a sequence from the Sequence dropdown menu.
- Multiple items at the same time — Add multiple library items and position them in the box to determine their onscreen layout.
Show web page — When selected and the trigger occurs, enter a web address in the Address field. This web page will display when the trigger is met. You can chose whether to allow users to be able to interact with it or not.
Launch application — When selected and the trigger occurs, this action will launch another application installed on the device. For example, open a ticket booking app or print a voucher.
Ask for information — When selected and the trigger occurs, enter information in the available fields to construct a simple dialog to request information from the user. For example:
Report information — When selected and the trigger occurs, this action will ask the viewer for information to submit, for example an email address or phone number. This information will be sent to our servers and be made available in the collected data report.
Add screen data — When selected and the trigger occurs this action will put some data into the screen data. This data can then be used elsewhere in the system; typically inside a condition. This makes it possible to build stateful sequences. For example, a screen could contain the data showWarning=true and an item could be configured to only show when showWarning==true. A trigger and this action could then subsequently set showWarning=false and prevent the warning from displaying again.
Show next item — When selected and the trigger occurs, the next item in the sequence is displayed when the trigger is met.
Show previous item — When selected and the trigger occurs, the previous item in the sequence is displayed when the trigger is met.
Branch back — When selected and the trigger occurs, if the viewer has jumped between sequences (as a result of an action branching to an inner sequence), this will return the viewer to the previous sequence.
Resume delay — If you have selected Show item, Show web page, or Launch application, you can enter a time by which to delay resuming the parent sequence.