Versions Compared

Old Version 66

changes.mady.by.user BrightSign TechDocs

Saved on

compared with

New Version 67

changes.mady.by.user BrightSign TechDocs

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Expand
titleTable of Contents
Table of Contents

...

Tip

The URL and Query string fields accept User Variable values. To specify a User Variable, enter the name of the variable between two sets of braces. The variable value can be either standalone ("{{my_variable}}") or part of a static value ("http://www.brightsign.biz/{{my_variable}}"). 

Options

Use the following checkboxes to enable optional, advanced features associated with the webpage:

  • Enable Node.js: Enables Node.js® for the HTML page.

  • Enable BrightSign JavaScript objects: Enables BrightScript-JavaScript objects for the HTML page.

  • Enable cross domain policy checks: Enables Chromium security checks for cross-origin requests.  

  • Ignore https certificate errors: Instructs the state to ignore security errors when connecting to insecure HTTPS hosts. Enabling this feature makes the player insecure; it is not suitable for production environments and should only be used for testing.

  • Force shared storage: In OS 8.2.55.4 and later, HTML widgets that are loaded from HTTP/HTTPS protocols do not share the same local storage database (HTML widgets that are loaded via file protocol act as they did in previous releases). This flag allows you to change the default behavior of widgets loaded through HTTP/HTTPS from "unshared" to "shared", or to change the default behavior of widgets with locally loaded files to "unshared" from "shared". Note that these settings are widget specific, so HTML widgets in a single presentation can have different shared storage settings.

  • Enable camera: Enables webpage access to USB cameras connected to the player (access is disabled by default). This allows support for WebRTC applications.

  • Enable mouse and touch events: Enable user interaction with the HTML page (clicking on links, interacting with JavaScript elements, etc.). 

  • Display Cursor: Displays a cursor whenever a USB mouse is connected to the player.

  • Enable native video playback: Enables HWZ mode on all <video> elements contained within the page. This increases the frame rate and quality of HTML video playback, but can also cause problems with CSS page transforms and other page elements. By default, it will place video on top of all graphics in the presentation and set the view mode of all <video> elements to Scale to Fill.

  • Enable javascript console: Enables the Chromium Web Inspector for HTML sites in the presentation. To enable the JavaScript console in BOS 8.5.31 and above, you will need to either:

    • Set the enable_web_inspector registry key (in the "html" section) to enable the JavaScript console (see the "inspector_server" in roHtmlWidget for more information)

    • Enable "Chromium debugging" in the BrightAuthor:connected RDWS (with BrightAuthor:connected version 1.7.11 and above) or the LDWS.

Note

For security reasons, Enable javascript console should only be used in non-production presentations. Make sure to disable JavaScript console before publishing to a production environment. In the Chromium version found in BOS 8.5 and beyond, the JavaScript console will log information in memory even when you are not connected to the inspector. This will consume memory until the player runs out, which will result in a crash.

Live Text State 
Anchor
live_text
live_text

...

A Live Text state consists of images and text fields overlaid on top of each other. You can layer both static text and updatable RSS and MRSS content with images and customize the position/size of items in relation to the background. 

...

  1. Add Item: Click the  icon to add a new item to the Live Text canvas.

  2. Layers: Click and drag a Live Text item to move it up or down the display order. Items that are higher on the list are displayed on top of lower items.

    1. Background: A permanent layer that is always displayed behind all items in the Live Text state. Use the Layer Properties to set the background to either a color or an image.

    2. Delete Item: Click the 

      Image RemovedImage Added

       icon to delete an item from the Live Text canvas. 

  3. Offset next: Check this box to set an initial position for new items in relation to the most recently created item. Input the offset distance for the next text item (in pixels) in the Left (X) and Top (Y) fields.

  4. Update Live Data: Refresh items that are populated from a remote URL (i.e. Live Text Data, RSS Feed, Media RSS Feed).

  5. Grid Lines: Check this box to include invisible gridlines on the Live Text canvas. When you manually move or resize elements by clicking and dragging them, they will snap to these lines. Enter the distance between gridlines (in pixels) in the Vertical and Horizontal fields.

...

The Media List state is a convenient tool for defining interactive events with many files in a single feed. By default, each time the playlist transitions to a Media List state, the next file in the list will play and exit the list after a timeout (images) or when the file finishes playing (video and audio). Alternatively, you can set the list to shuffle files or cycle through every file in the list before exiting and transitioning to the next state.

Note

When the Media List state is double-clicked, the Media List canvas will appear. The Media List canvas gives you the option to add content from Assets to the Media List. To exit this canvas, click the Zone description located in the top left corner of the canvas. This will take you back to the Zone Content canvas. 

List Content

Use this section to specify how the Media List is populated.

...

The On Demand state allows you to combine media files into a single state in the playlist area. You can then use the event that transitions to the On Demand state to conditionally determine which file in the playlist should be played.

Note

When the On Demand state is double-clicked, the On Demand canvas will appear. The On Demand canvas gives you the option to add content from Assets to the On Demand state. To exit this canvas, click the Zone description located in the top left corner of the canvas. This will take you back to the Zone Content canvas. 

The On Demand state can only be transitioned to using input from BP900/BP200, UDP, Serial, Keyboard, or USB devices. The input data from the controller will determine which media item in the On Demand state will be played: For example, you can use a Keyboard Input event to playback “Video 1” if the “A” key is pressed, “Video 2” if the “B” key is pressed, "Video 3" if the "C" key is pressed, etc. Any type of event can transition out of a Play File state and into a new state.

For BP200/BP900 events, you must specify each Key using both the panel enumeration and button number: For example, if you have a single BP200/BP900 panel connected to the player and want button 3 to trigger an image, you would specify the Key as "0-3"; on the other hand, if you have a second BP200/BP900 panel connected to the player and want button 3 on the second panel to trigger the image, you would specify the Key as "1-3".

  • Populate From Feed: Populate the On Demand state using a feed.

    • URL: Specify the URL of an RSS feed (this feature does not support MRSS feeds). In the example below, <title> is the On Demand key value and <description> is the media download URL.Upon playing the presentation, the player will retrieve media from the download URLs specified in the <description> field of each item in the feed. The On Demand state will use the value in the <title> field as the key to determine which media item to play.

      Code Block
      languagejs
      <rss xmlns:media="http://search.yahoo.com/mrss/" version="2.0">
    <channel>
        <title>The Feed</title>
        <link>https://site.com/</link>
        <description>The videos</description>
        <generator>Server RSS Generator</generator>
        <item>
            <title>myvideo.mp4</title>
            <pubDate>2022-08-24T17:29:30.74Z</pubDate>
            <link>https://site.com/myvideo.mp4</link>
            <description>https:/site.com/myvideo.mp4</description>
            <medium>video</medium>
            <media:content url="https://site.com/myvideo.mp4" fileSize="25863908" type="video/mp4" medium="video"></media:content>
        </item>
    </channel>
</rss>

    • Dynamic Playlist: Populate the On Demand state using a Dynamic Playlist from your BSN Content Cloud library. The On Demand state will use the filename as the key to determine which media item to play.

    • Live Media Feed: Populate the On Demand state using a Live Media Feed from your BSN Content Cloud library. The On Demand state will use the Title of the feed item to determine which media item to play.

    • Update Interval: Specify how often the player should refresh the contents of the feed.

    • Parser Plugin: Select a feed parser to parse the feed data before it is passed to the On Demand state.

    • Optimize Feed Updates (use HEAD calls): Check this box to have the player make an HTTP HEAD request before retrieving the contents of a feed. See here for more details.

    • Automatically generate User Variables from Data Feed:  Use the feed to populate a set of User Variables for HTML pages. See here for more details.

  • Display default media if input does not match any keys: Check this box to display the specified media file when the input data does not match any existing keys in the On Demand state. If this box is not checked, and the input data does not match an existing key, the presentation will not transition to the On Demand state, remaining on its current state instead.

  • Use variable to specify key: Check this box to have a User Variable specify the media-file key. The input data from the controller will be ignored, though input of some kind must be received to trigger the interactive event. For example, if a Keyboard event is attached to the On Demand state and this option is enabled, any key press will initialize a transition to the Play File state; the value of the specified User Variable will then be checked against the keys in the On Demand state to determine which file, if any, should be played.

...

If you create a large, complex interactive playlist, you will likely run into two problems: You’ll find yourself having to create a large number of redundant events, and it will become difficult to keep track of numerous branching states and conditions. Super States are implemented to alleviate these problems and make complex interactive presentations manageable.

Note

When the Super State icon is double-clicked, the Super State canvas will appear. The Super State canvas gives you the option to add media states from Widgets to the Super State. To exit this canvas, click the Zone description located in the top left corner of the canvas. This will take you back to the Zone Content canvas. 

The primary mechanic of the Super State is that it functions as both a state and a self-contained interactive playlist. A Super State can be transitioned into and out of using any event, but double-clicking it will reveal a new interactive playlist canvas contained within the original. There are several behaviors that are unique to this state:

...