ON THIS PAGE

Conditional Targets and Commands are advanced features for interactive playlists. Conditional Targets are available for events, while Commands can be added to both events and states.

Click the Advanced button in the State Properties or Event Properties pane to add or edit Conditional Targets and Commands.

Conditional Targets

Conditional Targets allow you to change the behavior of an event transition depending on the value of a User Variable. You can set multiple Conditional Targets for a single event, and you can specify new commands to occur when the Conditional Target is met. With this feature, you can change the behavior of a presentation based on a wide array of interactive and networked conditions.

  1. Add Conditional Target: Click this button to add a Conditional Target to an event.
  2. Variable: Select the User Variable that will trigger the Conditional Target.
  3. Operator: Select the conditional operator that will compare the current value of the variable against the value set in the field to the right. The Target state and Commands defined below will only occur when the entire statement—the variable, the operator, and the target value—is true. 

  4. Value: The value that the User Variable value will be compared against.

    In the Value field, you can enter either a fixed integer or the name of another User Variable (e.g. “when Variable A is equal to 42” or “when Variable A is equal to Variable B”). You must enter the name of a target User Variable between two sets of braces (e.g. “{{my_variable}}”).

  5. Target State: Select the transition behavior that will occur if the Conditional Target is met.
  6. Command: Add commands that will be executed if the Conditional Target is met.

Commands 

Commands allow you to add extended functionality to your presentations. Commands can help you control displays and devices (Display On, GPIO On, etc.) or perform additional actions when interactive events are performed (Pause Video, Set Volume, etc.).

You can add commands to interactive events or to states. If you add a command to an interactive event, the command will be performed when that event occurs. If you want to add a command to a state, you will need to choose between an Entry Command (executed upon entering the state) or an Exit Command (executed upon leaving the state). Some commands (such as Switch Presentation) can only be added to interactive events.

Set Panel Output

This section has an accompanying tutorial video:

Configures the LED output of an attached USB device (BP200, BP900, or BLC400)

If you're connecting a single BP/BLC device to a player, use the "A" version of the device (e.g. "BP900A"). If you plan to connect multiple BP/BLC devices to a player, see here to learn more about using the A, B, C enumerations.

BP900/BP200

BLC400

You cannot use multiple BLC commands to simultaneously trigger multiple LED patterns (e.g. a breathe effect on channel A and a marquee effect on channel B). BLC commands that belong to the same event/state will trigger in descending order at slightly offset intervals.

 You will also need to specify the pattern timing for marquee effects:

For the "Smooth" options, the ramp up and ramp down intervals are fixed at approximately 20 percent of the On time. 

Set Audio

Changes the audio settings of a zone. Note that triggering the Set Audio command while an audio/video file is playing will cause playback to freeze (though the player will still respond to interactive events like Timeout, UDP, etc). You can also use the Set Audio command while displaying an image file, or you can attach the Set Audio command to an interactive event that transitions to or from an audio/video file.

Connector Volume

Changes the audio volume of a specific connector.

Zone Volume

Sets the volume for a zone. Note that the Connector Volume settings take precedence over the Zone Volume settings when both are active in a presentation.

Send 

This section has an accompanying tutorial video:

+ 

Sends information using the following interfaces:

Most standard serial devices enumerate on port 0 (on the HO523, they will enumerate on port 1). If you are connecting a USB-serial device, it will enumerate on port 2.

Link 

Connects presentation zones or synchronizes BrightSign players.

GPIO 

Changes the state of GPIO buttons that are configured for output.

The "button" numbers described below are not the same as GPIO "pin" numbers: Some pins act as power supply or ground, so they are not included in the button numbering scheme. See the Hardware Interfaces section of the hardware manual  associated with your player model to view a mapping of buttons to pins.

Video

Changes the video playback settings:

BrightControl

Sends commands to monitors and other digital signage displays:

Other 

Sends various commands that are not contained within the above categories.

The Increment Variable and Decrement Variable commands have the following special rules:

  • If the command is used on a number with a decimal value, the number will be converted to an integer by removing the decimal (i.e. the number is always rounded down).
  • If the command is used on a string, the value will be converted to a zero. Then the increment/decrement action will be performed on the zero. Negative numbers are also possible.

 The Hide Zone and Show Zone commands do not affect Audio Only, Enhanced Audio, or Background Image zones.