BrightLink

brightlink provides a touchless interactive solution for any digital signage application by enabling users to view and control an interactive digital sign with their mobile phone brightlink uses proven brightsign technology that can easily be deployed with confidence for new and existing installations brightlink does not need an internet connection or a phone app to connect to or control the digital sign with brightlink, touchless interactive experiences can be achieved both onscreen using our vast collection of brightsign features, and on user's phones through the custom device webpage using html programming that is optimized to run on connected phones brightlink supports two engagement options 1 way engagement plays content on a phone to enhance or augment the onscreen experience it can also work without a screen, so the user’s phone becomes the digital sign 2 way engagement provides customers with the ability to remotely control a display using their phone this page explains brightlink requirements and components, as well as how to implement it in {{brightauthor classic}} presentations using the example project provided in brightlink bigboxmedia v0 0 93 package zip the bigboxmedia brightauthor classic project is an interactive movie trailer kiosk that uses a brightlink experience instead of a traditional touch screen how it works the brightlink solution configures the brightsign player to act as a web server which uses the installed wireless module as a wi fi access point and hosts a custom device webpage containing your content this allows a user to connect their phone to the broadcasted wi fi network or ssid which does not offer internet access (the ssid is a user variable set to bigboxmedia in the example) once the user’s phone is connected to the wi fi access point, they can scan a qr code linked to a hostname variable which will automatically open a phone’s default browser to display your content as a smartphone optimized custom device webpage a brightsign player configured for brightlink not only plays the digital signage presentation shown onscreen, but also hosts the custom device webpage displayed on a connected user’s phone and manages the interactivity between the player and the connected phone 1 way engagement this implementation of brightlink lets a user view custom content on their connected phone that matches, enhances, or augments what is shown onscreen many phones can be linked at once to the brightsign player’s wi fi access point to view content this implementation can also operate without a screen, using printed instructions to help users connect with the wi fi access point and then scan a qr code to view content applications could include company directories, printed retail shelf informational signs, or coupons, museum exhibits, and more 2 way engagement this implementation of brightlink lets a user view custom content and remotely control onscreen content playback from their connected phone this implementation is called 2 way engagement because the user controls the onscreen experience and the brightsign player delivers content to the connected phone and screen while listening for and triggering onscreen events based on selected phone commands 2 way engagement must be designed into both the onscreen brightauthor classic project and the custom device webpage displayed on the connected phone only one phone can be linked to control the experience at once, much like only one person can interact with a touch screen at any one time brightlink developer package the downloadable brightlink v0 0 93 package zip contains these folders brightlink bigboxmedia v 0 0 93 which contains a brightlink demo with 2 way engagement including the brightauthor classic project file, associated source files, and content as shown to the right brightlink docs which contains the information on this page in brightlink userguide v093 pdf brightlink requirements player requirements any series 3 or 4 brightsign player running brightsignos v8 1 69 or higher os downloads are available here https //www brightsign biz/downloads/overview an installed wireless module (ws 103) the wireless module is solely used for brightlink functions and cannot be configured or used for publishing presentations or any other functions wi fi module signal strength can be reduced using an attenuator or by removing the antenna from the back of the device for maximum signal reduction see our video instructions https //www youtube com/watch?v= ck3rskjxbq on how to install a wireless module a microsd card with a published brightlink presentation created in brightauthor\ connected or brightauthor classic player setup a brightsign player running a brightlink presentation configures the installed wireless module to act as a wi fi access point therefore, the wireless module cannot be used for any other purposes such as a wi fi client or for publishing presentations via brightauthor classic or brightauthor\ connected if repurposing an existing player, you must factory reset your player hold down both the svc and reset buttons while applying power until the red light starts to flash quickly, then release the buttons if the player does not reset fully, contact our support team https //brightsign zendesk com/hc/en us/requests/new for a reset script install os 8 1 69 or higher os downloads are available here https //www brightsign biz/downloads/overview setup the player do not enable wireless under network properties brightlink uses the wireless module to connect and communicate with a linked phone and cannot be used for other functions like publishing presentations under unit configuration , select enable diagnostic web server this allows you to access the admin portal (accessible at ) if you do not enter a password, no password will be needed to access the admin portal it is highly recommended that you enter a strong password here to ensure that the admin portal is secure the traditional diagnostic web server is not accessible via the wireless module for brightlink applications, so the only way to access the diagnostic web server is with a wired ethernet connection using the setup username and password under unit configuration , check the box to enable local web server , but do not enter a username and password if login credentials are set, the user will need them to view your menu content under unit configuration , choose your preferred publishing method, such as standalone if you choose a networked publishing method, wired ethernet must be used – the wireless module cannot support networked publishing for brightmenu applications brightauthor classic project requirements brightlink requires the following elements in a brightauthor classic project file to implement its functionality on a brightsign player each elements are described in detail in “implementing brightlink in brightauthor classic” brightlink user variables (appropriately set in a brightauthor classic project file) plugin file set player as access point plugin brs plugin file httpserver npm auto v3 brs npm zip file instructions zip file (only used in brightlink 1 way presentations) custom device ebpage (created for and optimized to run on a smartphone) qrcode hostname html qrcode ssid html (optional) brightlink deployment wireless signal range when deploying brightlink, it is a good idea to adjust and test the wifi access point signal range of the installed wireless module the typical signal range of a brightsign player with an installed wireless module and connected antenna is about 15 feet attenuators can also be used to help reduce the wireless signal range when the wireless module antenna is not used, the wireless signal range can drop to about four to five feet the signal range is also affected by where the player is located (for example, in line of sight of the user or mounted behind a display) not required for deployment internet access to the player is not needed, which makes it extremely easy to deploy in a wide variety of applications user phones do not need a particular app installed in order to connect to the player, view the custom content, or control the digital sign playback brightlink uses existing features available on all smartphones to connect to a wi fi access point hosted by the brightsign player and to scan qr code 1 way engagement implementations of brightlink do not require a display, but one can be employed to enrich the experience if a connected screen is not used, use a printed sign to explain how to connect to the wifi access point and display a scannable qr code so users can view the content hosted on the brightsign player if using a printed sign for your application, a connected display can be useful for setup and testing purposes as shown in our brightmenu example brightlink in brightauthor classic 1 way engagement brightauthor classic projects designed for brightlink 1 way engagement primarily employ the following elements configures the brightsign player as a wireless access point hosts an image or a custom device webpage that gets viewed as on a connected phone optionally plays non interactive content on a connected screen this approach can be good for applications that don’t have or require a display, such as a retail shelf with a qr code to scan for a coupon, or a museum exhibit with a qr code to scan for more information see the brightlink 1way v0 0 9 3 example for a demonstration of how a 1 way engagement application can display images on a user’s phone instead of custom device webpages there are many different ways to apply 1 way engagement for an even wider variety of applications using custom device webpages 2 way engagement brightauthor classic projects supporting brightlink 2 way engagement primarily employ the following elements configures the brightsign player as a wireless access point hosts an interactive custom device webpage that can be viewed as a menu on a connected phone plays interactive content on a connected screen that listens for and executes on commands sent by a connected phone using udp commands to trigger actions on the brightsign player is the most straightforward way to implement interactive controls in a brightlink presentation these udp commands can trigger actions such as playing specific video files onscreen, playing specific audio files, changing led lighting, and more essentially the udp commands can trigger whatever actions brightsign supports, making the implementations limitless other ways to implement interactivity between a connected phone and the brightsign player can also be employed in brightauthor classic such as employing user variables and zone messaging to trigger playback in the movie kiosk example, the brightauthor classic project file listens for udps from the custom device webpage running on a connected phone and then plays back the selected videos with a video play file widget brightlink user variables brightlink supports an array of customizable user variables allowing you to tailor the experience for your implementation these variables configure the associated plugins which in turn program your brightsign player to perform as a web server and wireless access point using the installed wireless module which does not need an internet connection the wireless module is solely used for brightlink functions and cannot be used for publishing presentations the user variables must reside in the brightauthor classic project file under presentation properties > variables connect status this variable is used to track whether or not a phone is connected to the wifi access point and using the custom device webpage if the value is “disconnected”, the wifi access point ssid is displayed onscreen notifying a user to connect if the value is “connected” then the ssid is hidden from view on screen in order to limit the number of users interacting at once ssid this variable is the name of the wi fi network broadcasted by your player it can be as descriptive as you would like to match your application the bigboxmedia demo example instructs users onscreen to manually connect to this ssid on their phone however, the demo also provides free html code that automatically generates a qr code based on the assigned ssid value (see qrcode control html https //brightsign atlassian net/wiki/spaces/doc/pages/404619929#brightlinkuserguide qrcode ) password this variable is the password needed to connect to the wi fi named under the ssid variable if you leave the default value blank, no password will be required by the user to connect hostname this variable is the address assigned to the custom device webpage hosted on the brightsign player which displays on a connected phone your name must end with a valid top level domain name https //en wikipedia org/wiki/list of internet top level domains#r such as com, now, link, etc otherwise, the value can be set to anything you would like to match your application the hostname also offers access to the admin portal by entering in the browser of a connected device we recommend that users access this hostname by scanning a qr code when scanned, the hostname translates to a url which a connected phone is pointed to play in its default web browser in the bigboxmedia example, free html code has been provided that automatically generates a qr code based on the assigned hostname value (see the “qrcode hostname html” section) ipstart this variable represents the start of the ip addresses available for the brightmenu wireless network hosted by the brightsign player ipend this variable represents the end of the ip addresses for the brightmenu wireless network hosted by the brightsign player set this user variable to a number that will provide an acceptable range of available ip addresses in order to support all of the users you would like to be able to connect to brightlink player at once for 1 way engagement this number can be set to hundreds for 2 way engagement it is advisable to restrict the number so that multiple users can't connect simultaneously (all potentially competing to control the playback of the digital signage at once) gatewayaddress this variable is the default gateway assigned to the brightlink wireless network ipaddress this is the ip address assigned to the player frequency this variable sets the wi fi frequency set player as access point plugin brs this plugin configures the brightsign player to act as a web server and a wi fi access point so a user device can connect to it internet is not required for the brightsign player to enable this brightlink feature this plugin file needs to be referenced in your brightauthor classic project under presentation properties > autorun > script plugins the name must be access (it is case sensitive) and the path must be indicated httpserver npm auto v3 brs this plugin starts a node server on the player and unzips npm zip to the card the plugin creates a /node folder containing server html and portal js files these files set up the player proxy to direct the connected phone to the custom device webpage hosted on the brightsign player the webpage’s url is accessible through the hostname user variable described previously this plugin also builds the server containing the admin portal webpage code this plugin file needs to be referenced in your brightauthor classic project under presentation properties > autorun > script plugins the name must be httpserver (it is case sensitive) and the path must be indicated npm zip the npm zip file contains all the files for configuring the proxy you can create your own node js® file to add further functionality to the experience this npm zip file must be referenced in the brightauthor classic project under presentation properties > files instructions zip the instructions zip file is only used for bright link 1 way implementations, to display images, instead of custom device webpages, on a user's phone this file is unzipped and the contents are placed into the uploads folder on the sd card when the presentation is run for the first time the zip file contains instructions png this image displays the first time a brightmenu presentation is run it is activated to display on a connected phone when the qr code is scanned it shows the user how to login to the admin portal, upload menu images, and activate them to display on smartphones specials1 jpg, specials2 jpg, museum jpg, transportation jpg these are sample images that can be activated to test for various retail, museum, and transportation applications the instructions zip file must be referenced in the brightauthor classic project at presentation properties > files custom device web page the custom device web page is the html content that displays on phones connected to a brightlink enabled brightsign player this content should be optimized to run on a mobile phone, not a brightsign player when a phone connected to the player’s wifi access point (ssid) scans a qr code, it opens the default web browser and displays the assigned custom device webpage there are multiple ways to create a custom device webpage to play content on a connected phone html content for viewing purposes only for use in brightlink 1 way engagement implementations the html can also simply display a png or jpg image, as brightmenu does (see the brightmenu demo and user guide https //docs brightsign biz/display/doc/brightmenu+user+guide for details) interactive html content that offers a user interface to remotely control a digital sign for use in brightlink 2 way implementations the custom device webpage in the bigboxmedia project is called product index html and is a sample to guide you in your own designs and applications please contact your sales representative if you would like a reference to a brightsign partner that is experienced in creating custom device webpages in brightauthor classic, the custom device webpage is assigned in presentation properties > variables this webpage is accessed via the assigned ‘hostname’ variable which a connected phone can view by scanning a qr code assigned to that hostname or by typing the hostname into any browser if using bsn cloud or brightsign network to publish your presentation, the html site name must be a unique name that does not match any other html site name saved in your account qrcode hostname html this free html code auto generates a qr code based on the assigned hostname user variable value once that value is changed, the qr code is auto generated for the new value in the bigboxmedia example demo, this html code is used to display a qr code onscreen in a zone that matches the hostname variable value this html code is also used to create the qr code that is generated and displayed within the admin portal when the same hostname variable value has been changed if you are using this html for onscreen content, the file needs to be referenced in your brightauthor classic project under presentation properties > html sites qrcode ssid html this free html code auto generates a qr code based on the currently assigned ssid and password user variable values once that value is changed, the qr code is auto generated for the new values the bigboxmedia example demo provides this html code but it is not used in the presentation to display onscreen if you are using this html for onscreen content, the file needs to be referenced in your brightauthor classic project under presentation properties > html sites admin portal the admin portal has primarily been designed for brightmenu to easily distribute menu images to patrons but it can be customized for brightlink applications by editing the html files in npm zip the provided admin portal allows you to update the hostname user variable and auto generates a new, downloadable qr code for it it also allows you to update the ssid user variables and the password to log into the admin portal the admin portal can be accessed by typing hostname/admin into the browser of a connected device (for the bigboxmedia example demo it is watch now/admin ) admin portal operations the default admin portal supports the following operations and customizations upload menu uploads any image file in jpg or png format only one file can be uploaded at a time select menu activates an uploaded file to be viewable when the qr code is scanned multiple image files can be selected and viewable if multiple images are activated, they will display in alphabetical order and can be viewed by scrolling vertically through them in a browser set ssid variable lets you change the ssid value to a custom name to make it easy for users to recognize and find your wi fi access point set hostname variable lets you change the hostname value to a custom name so you can match the name to your application and offer an easy way for connected users that can't scan a qr code to enter the hostname in their browser to see your custom content note that the hostname must end with a valid top level domain name https //en wikipedia org/wiki/list of internet top level domains#r such as com, now, link, etc password to ensure that your broadcasted content is secure, update the password to log into the admin portal qr code image this image automatically updates when the hostname value has been updated it can easily be saved and communicated to users onscreen or as a printed sign login credentials login credentials are not required to enter the admin portal unless a password has been set for the diagnostic web server in the player setup process if the password field is left blank, then a password won't be required and the sign in screen to the admin portal will not be displayed if a password has been set, the username will be set to admin and you be prompted with a sign in screen when accessing the admin portal you can change the password at any time through the admin portal update the admin portal password these fields allow you to change the password to enter the admin portal at any time if the password was not set during the player set up process, then the default password is blank and no password is required once a new password is entered and update password is selected, the user will automatically be logged out and must sign back into the admin portal with a username of admin and the new password reset the admin portal password you can reset your password at hostname/forgotpassword (in the bigboxmedia example it can be accessed at watch now/forgotpassword ) follow the onscreen instructions note that the svc button is used in the password reset process, so the normal svc button operation is no longer supported however, a line of code in the httpserver npm auto v3 brs plugin can be uncommented to return the svc button to normal operation if desired change the ssid and hostname this section walks through how to change the name of your wi fi network ( ssid ) and the name of your custom device webpage ( hostname ) so that they match your application connect to ssid on your device login to the admin portal by typing hostname/admin into your browser for example, in the brightmenu demo, enter watch now/admin under the hostname section, enter the name of your webpage note that your name must have a period in it under the ssid section, enter the name of your menu’s wi fi network choose the set values button to apply your new names note that this will reboot your brightsign player and configure it with the new names it will also create a new qr code assigned to your new hostname scroll down to the qr code and save the qr code image that was generated for the webpage you just created and add it to your digital sign or printed placard for users to scan once the player reboots, you will be able to connect to the new ssid and scan the updated qr code to view your content at the new hostname brightlink bigboxmedia demo example this section describes how to setup, publish and operate the brightlink bigboxmedia project demo equipment setup & publishing setup a brightsign player as described in brightlink requirements connect the player as shown in image 1 open the provided brightlink movietrailers wifiname bpf presentation in brightauthor classic or brightauthor\ connected you will be prompted to locate the necessary files publish the presentation to an empty micro sd card use the publish method you selected during setup – either standalone to a micro sd card or over a wired ethernet connection using your selected networked publishing method wireless publishing is not supported with brightlink insert the micro sd card and reboot the player the player may take extra time to boot up as it configures itself for brightlink presentation operation you can interact with the player after it boots up and shows the main big box media screen as in image 2 follow the onscreen instructions to connect your phone and control the experience using a smartphone, connect to the bigboxmedia wi fi network as prompted onscreen as step 1 a password is not required once connected, scan the onscreen qr code to do this, open the camera app and aim the phone at the qr code this will automatically grab the code tap the notification to open the “watch now” url in your browser (see image 3) your phone now displays the user interface to control the kiosk and the kiosk display now shows a movie select screen (see image 4) 4\ using the interface displayed on your phone, tap on a movie image to view its movie trailer on the kiosk, as in image 5 operational notes you can select another movie trailer at any time by selecting an image on the phone after a video ends, it will return to the movie select screen which will time out back to the main screen after 30 seconds to quickly return to the main screen, select the home button in the upper left corner on your phone, as shown in image 6 the phone will automatically disconnect from the wi fi connection when it is out of range customizing the user connection there are several different ways for a user to connect to a brightlink digital sign for 2 way engagement brightsign recommends option one, below, as the simplest process (it is depicted in our movie kiosk demo) options two and three can also be easily implemented to meet the needs of any application option 1 manual join and qr code to launch the webpage users can manually connect to wi fi with an on screen prompt displaying the ssid users can scan a qr code to launch the interactive custom device web page option 2 dual qr codes scan a qr code to join the wi fi connection for your display (using the ssid / password variables) scan a second qr code to launch a default browser with your hostname option 3 qr code to join and manual webpage launch use a qr code to join the wi fi connection display the hostname for the user to type into a browser (the hostname is here in figure 9) developer notes to make custom edits to the http servers, etc , a version of unwebpacked portal js is available on request