We have seen partner integrations run the gamut from smooth and efficient to slow and bumpy. To assist partners in getting up and running as efficiently as possible, we’ve compiled a list of technical best practices to maximize your chances of success.
brightsign-dumps Folder
When developing custom autoruns, do not forget to include instructions for the autorun to create a brightsign-dumps folder on the player. The brightsign-dumps folder is used to store crash information and is very useful to BrightSign support when troubleshooting.
Free Tools
BrightSign offers a plethora of free tools via bsn.cloud that greatly ease provisioning and diagnostics. Partners are highly encouraged to take as much advantage of these tools as possible as it accelerates development and also makes support and troubleshooting much easier.
Memory Management
BrightSign players are purpose-built for digital signage. Players are not general-purpose devices and they do not have, nor do they require, as much memory as a typical Mac or PC. When developing for the BrightSign platform, developers should be cognizant of potential memory limitations that they may not be accustomed to.
OS Updates
Partners should try to use the latest BrightSign OS builds in order to take advantage of the latest bug fixes and newest features. Keeping up to date with the latest OS build also enables partners to more easily expand their deployments with our latest hardware.
We are continuously improving the firmware on our players, but as is often the case with software, problems are sometimes inadvertently introduced. A stable player is paramount to any BrightSign integration, so we strongly encourage partners to thoroughly test any BrightSign firmware releases prior to upgrading any players being used in a production environment.
Set Source to Blank
It is fairly common for a presentation to involve switching from one video being played to another video being played. In such cases, it is important to reset the source to blank prior to switching players. If this is not done, the first video player will continue to use memory even though its video is no longer being displayed.
limited # of decoders in players
https://brightsign.zendesk.com/agent/tickets/308237
[ 79.147] Failed to find a video decoder
HTML <video> Tag
The src attribute of the <video> tag should be set to blank. Why? A bit more detail needed here. More detail about HTML <video> tags can be found here.
video.src = ""; // release the video element.
You can have more than this amount of <video> elements on a page as long as additional <video> elements have their src attribute set to an empty string ← What does this mean?
Smooth Video Transitions
If multiple videos are being displayed sequentially, it is generally desired for one video to transition smoothly into the other one. To help ensure this, make sure that both the first and last frames of the videos do not consist of a blank frame. The presence of even one blank frame between videos can result in a noticeably jarring transition between videos.
Upgradeability
Change is inevitable so partners are recommended to design their apps with the ability to push updates to players remotely. This applies not only to the partner app itself, but also to diagnostic scripts which can be very useful for troubleshooting.
In addition to these technical best practices, partners are also recommended to follow these operational best practices.