Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Info

While BrightAuthor:connected users may find the info presented on this page interesting, it is not strictly necessary for them to understand these concepts because BrightAuthor:connected automatically takes care of these details.

CMS partners who are looking to integrate with BrightSign’s products may find this high-level explanation of player configuration helpful.

Player Configuration

When a fresh-from-the-factory BrightSign player is unboxed, it cannot do much without first being configured.

Configuring a player is the process in which a Setup is applied to the player. The Setup applies various settings to the player (network settings, logging, etc.) and includes a Player App which provides instructions for what the player should do upon startup.

...

image-20240305-232724.pngImage Added

Player Provisioning

Provisioning specifically As mentioned, provisioning refers to using BSN.cloud to configure a player. Given , and given that BSN.cloud (either the Control Cloud or Content Cloud tiers) is used the vast majority of time to configure players, the term provision is often used when referring to player configuration.

...

  • Standalone player configurations where the Setup is manually copied to a storage device and then the storage device is connected to a player.

  • Uncommon situations where a partner chooses to configure players without using BSN.cloud.

...

With BSN.cloud

...

Setup

A Setup establishes various player settings and may include the following:

...

Network settings (wired, wireless, username/password, etc.)

...

Player name and description (more descriptive info for the player beyond its unique serial number)

...

Time zone (especially relevant for geographically dispersed players)

...

Publishing Mode (tells the player how to retrieve content; more details about these modes here)

...

Diagnostic web server (enables access to a wealth of diagnostic info on the player)

...

Logging (enables the capture of various types of logs)

...

Debugging (enables debugging tools)

...

, provisioning a new player can be nearly automatic - if things are properly set up beforehand, new players can be automatically provisioned just by plugging them in! For customers who can’t or don’t want to connect to the internet, offline provisioning options are also available.

Setup

Setups can be created in BrightAuthor:connected or the aforementioned free and unbranded Control Cloud at control.bsn.cloud. Setups can be saved to a library, modified, and applied to other players.

Once created, Setups can be applied to a player or group of players using either BrightAuthor:connected or control.bsn.cloud. Alternatively, the information contained in a Setup can be directly incorporated into the Player App (described below) and manually copied to the player’s storage device.

Partners also have the ability to use our APIs to connect their CMS directly to the Control Cloud, enabling their CMS, rather than the Control Cloud, to function as the user interface for player provisioning.

BrightSign Default Setup

Unless a player is explicitly assigned a specific Setup, the BrightSign “Default Setup” will be applied. With the BrightSign Default Setup, the player will search for a network connection via Ethernet and, if a connection is found, obtain an IP address using DHCP.

If the player has a Content Cloud subscription (or is using the free trial), the player’s default Publishing Mode will be BSN.cloud. If the player does not have a Content Cloud subscription (and is not using the free trial), the player’s default Publishing Mode will be Local Network.

Many users may find that the BrightSign Default Setup is acceptable for their needs in which case explicitly applying a Setup is not required. However, the Player App (described below) is always required - the player needs to know what to do when it starts up!

Custom Default Setup

Users have the option of using another Setup (instead of the BrightSign Default Setup) to function as the default that is automatically applied to players that have not been explicitly provisioned. This involves creating a new Setup specifically named “Default Setup” (case and spelling must match exactly as shown). By using a Default Setup, players do not have to be explicitly provisioned - any player not explicitly provisioned will have the Default Setup automatically applied upon activation.

More details about Setups and provisioning can be found hereMore info about Setups can be found here and more info about provisioning can be found here.

Player Settings

The Setup establishes various player settings which include things like Publishing Mode, network settings (Ethernet, WiFi, etc.), player identification (name and description), logging, and more.

Player App

The set of files and folders that instruct the player what to do upon boot up is collectively known as the Player App. At a minimum, the Player App must contain an autorun.brs file (the .brs extension denotes a BrightScript file) which instructs the player what to do upon startup.

...