Broadsign supports the display of dynamic HTML5 content on Broadsign Control Player. To enable this content, we provide a number of tools and configurations:
- Transparency effects
- Content caching
You can enable Chromium in the Products section of your player configuration profile. See The HTML Tab.
Note: As of Broadsign Control v13.2, we support Chromium version 74+.
Note: As of Broadsign Control v11.1, Chromium will not work on WinXP (though it will work on v11.0 and earlier). If you attempt to use Chromium on WinXP (Broadsign Control v11.1+), you will receive the following error message: "[2018-08-01T15:29:51](message) Frame [YourFrameID]. Could not play ad copy id [YourAdCopyID]. Could not find an appropriate codec."
Note: As of v11.1.0, Broadsign updated the version of Chromium we use with Broadsign Control Player. If you are updating to Broadsign Control v11.1.0+ from v10.3.0-v11.0.0, and use Chromium, you will need to create a new configuration profile for v11.1.0.
If you want, you can render HTML5 content semi-opaque or completely transparent. Transparency will provide effects similar to the following image:
For details about system requirements and configuring Broadsign Control Administrator, see Transparency.
You can upload HTML5 packages just like videos. HTML5 packages can be previewed and approved to win auctions just like videos.
The Broadsign Control Player’s disk monitoring function will process Broadsign Reach-delivered HTML5 package with the same atomicity as it does in Broadsign Control.
If the player does not have time to download and unzip the HTML5 package before the ad slot needs to play, the slot is skipped.
Broadsign Control Player will accept an "asset_url” in the AdResponse that points to a “.x-html-package”.
Broadsign Control Player will accept a mime of “application/x-html-package” in the AdResponse.
Once you enable the Chromium browser, you enable our Chromium caching mechanism, by default.
As a result, if there is no network connection, or if the document takes a few seconds to fully load and you do not want customers to see an incomplete page on screen, Broadsign Control Player will use content from the cache.
For more information, see The HTML Tab.
Note: If your HTML Package contains a video that should start at the moment the Ad Copy is displayed on screen, use the BroadSignPlay() function. This function is called at the same moment the Ad Copy is displayed on screen, allowing you to pre-buffer the content and control its starting time. For more information, see BroadSignPlay().
You can retrieve data from the Internet by using your HTML Package in two ways:
- Directly, such as displaying a video.
- Indirectly, such as fetching information through an API to then decide what to display on the screen.
The origin of an HTML file executed outside of a web server is "file://". By default, many servers will prevent requests from said origin to be executed, as an ongoing process to prevent XSS (cross-site scripting) attacks.
If you are managing the remote server to which your HTML file is pointing, make sure that the header Access-Control-Allow-Origin is set to "*". This will allow the origin of the requester to be anything. Doing so, however, may introduce a security risk, so Broadsign suggests to add custom headers in your request that will allow the remote server to authenticate the requester as legitimate. The custom header can be a token that the remote server will verify and either accept or refuse the connection.
If your web redirect ad copy produces an HTTP error -- whether client (4xx) or server (5xx) -- the player will skip to the next item in the loop. Skipping the content ensures that neither error messages nor black screens appear on your monitors.
If you are using the Chromium web browser, and nothing is drawn on the screen at playback time even if the HTML file is not empty, the Ad Copy is discarded.
For more information, see HTTP Errors and Incidents.