Variables
This page / section pertains to BrightAuthor Classic, our legacy app. BrightSign Author is our latest app for managing content and players.
Development of BrightAuthor Classic has largely ceased and the app will eventually be deprecated and replaced with BrightSign Author.
Use this tab to configure the device web page, enable Media Counters, and create User Variables.
Device Web Page Display
The device web page allows you to view and edit User Variables over your local network. In order to display a standard or custom device web page, you must first enable the Local Web ServerLocal Web Server during player setup.
- No device web page: Choose this option if you would like to enable the Local Web Server but do not want the User Variables webpage to be accessible.
- Standard device web page: Choose this option to enable the default device web page, which lists all User Variables and their default/current values on a sparsely formatted page.
- Custom device web page: Choose this option to use a device web page with custom appearance, formatting, and functionality. See Custom Internal Web Page for more information.
- Alphabetize variable names: Check this box to list variables on the Device Web Page alphabetically, rather than by order of creation.
If you plan to use the device webpage, ensure that your User Variables do not have names containing an ampersand ("&") character. If any User Variable name uses an ampersand character, the User Variables Webpage will fail to display any variables.
User Variables
User Variables are customizable values that can be used in commandscommands, Live TextLive Text and User VariableUser Variable states, and Conditional TargetsConditional Targets. When used in Live Text and User Variable states, User Variables display the current value of the variable. The value can also be changed during a presentation using the Set Variable or Reset Variable commands.
- Automatically create media counter variables: Check this box to create Media Counters for all media files in the presentation. Media Counters record how many times a file has played in a presentation. They can be displayed in Live Text or extracted from the BrightSign player via USB. For details on retrieving Media Counters via USB, see the Using Advanced ToolsUsing Advanced Tools page.
- Reset variables to their default value on presentation start: Check this box to reset all User Variables to their default values whenever the presentation begins. If this box is unchecked, User Variable values will be preserved on the SD card after the device reboots, the presentation is switched, etc.
- Update frequency for networked variables: Use the dropdown list to determine how often networked User Variables should be refreshed by Data FeedsData Feeds that are assigned to the presentation.
Add User Variables
Click Add Variable to add a new User Variable to your presentation. Then, specify the following:
- Name: Enter a unique name for the User Variable. Variable names must not contain an ampersand ("&") character, otherwise the User Variables webpage will not display any variables.
- Default Value: Specify an initial value for the User Variable. Whenever a User Variable is reset (via the Reset Variable commandcommand), it will return to this default value.
Setting a new Default Value and republishing the presentation will not set the value of that variable to the new default value. Instead, the variable will retain whatever value it had before the publish operation. To set variables to their new default values, you will need to check the Reset variables to their default value on presentation start box before publishing the presentation. To set a single variable to its new default value, use the Reset VariableReset Variable command.
- Access: Select Shared to make the User Variable accessible to other presentations scheduled on the player. If two presentations use a variable with the same name, the value of the variable with the Shared attribute will be used for the variable with the Private attribute.
- Type: Select a User Variable type:
- Local: Local variables can be changed with the Set Variable/Reset Variable commandscommands or via the Local Web ServerLocal Web Server. They can also be set with properly formatted serial, UDP, and Plugin Message commandsserial, UDP, and Plugin Message commands.
- Networked: Networked variables are set and modified using Data FeedsData Feeds (RSS, Live Data, or Dynamic Playlists). To create a networked User Variable, you must first specify the Data Feed it will be linked to. Select the desired Data Feed from the dropdown list and click Validate to ensure the link is operational and has correct RSS formatting.
- Every RSS entry has a <title> value and a <description> value: use the <title> value to designate the name of the User Variable being modified; use the <description> value to change the value of the User Variable.
- SystemVariable: System variables are not determined by the user, but by independent system parameters, such as firmware/autorun version number, IP address, RF channel count, and various types of EDID (extended display identification data) information received from the display over HDMI®.
- Displays will often lack a complete set of EDID parameters. Make sure to test the EDID values of a certain display model before using them in a presentation.
To delete a User Variable, click the X beside the appropriate variable. You can also use the Delete Unused User Variables button to delete all user variables that are not currently in use by Live Text states, commands, events, conditional targets, etc.
User Variables and Commands
User Variables can be used to dynamically set the parameters of many commands: Set Volume, Increment Volume, Decrement Volume, Send UDP, Serial-send string (EOL), Serial-send string (no EOL), Serial-send byte, Serial-send bytes (comma separated), Synchronize, Send Zone Message, Link Zones, GPIO On, GPIO Off, GPIO Set State, BrightControl – Send Ascii String, BrightControl – Philips Set Volume, and Pause.
For example, if you add a Set Volume command to your presentation and use a static value like 50, the volume will always be set to 50 when the command occurs. If you use a User Variable instead, the volume will be set to the current value of the variable, which could be any value based on Set Variable commandscommands and any number of other factors.
To utilize a User Variable in a command, first add the command (see the CommandsCommands page for details). Then, in the Parameters field, enter the name of the variable between two sets of dollar signs (e.g. “$$variable1$$”). The variable be not be recognized without these dollar signs.