Object Reference

brightsign players use a standardized library of brightscript objects to expose functionality for software development to publish a new api for interacting with brightsign hardware, we create a new brightscript object the pages in this section provide definitions for objects that can be used in brightscript a brief description, a list of interfaces, and the member functions of the interfaces are provided for each object class while most brightscript objects have self contained pages, some objects are grouped on the same page if they are closely related or depend on one another for functionality here is a sample of objects that are used frequently when creating applications in brightscript rovideomode docid\ qq734nqz0hcwni0unsdmp configures video output and interacts with displays using cec/edid docid 3e73tpeml1 oebs2goauq used to define zones/widgets on the screen this object is passed to many other objects to define their screen area, including rovideoplayer , roimageplayer, roimagewidget , rohtmlwidget , roclockwidget , and rocanvaswidget rovideoplayer docid\ ztuz0ldazcml2kqmdbkcn plays video files, streams, and hdmi® input docid 0umxqyvruy7drnluuzafp displays images docid\ xljq5 yhdma2ssmpzimtk displays local or remote html content using the chromium rendering engine docid\ u6zceyqddlz9xdakttmjs used to configure ethernet, wifi, and local network parameters docid\ utkdmpos1ulxaoylx1ns6 used to retrieve a wide array of system information, including model type, device serial number, and firmware version interfaces and methods every brightscript object consists of one or more "interfaces " an interface consists of one or more "methods " for example, the rovideoplayer object has several interfaces, including ifmessageport the interface ifmessageport has one method setport() the abstract interface ifmessageport is exposed and implemented by both the rocontrolport and the rovideoplayer objects once the setport() method is called, these objects will send their events to the supplied message port this is discussed more in the event loops section below example p = createobject("romessageport") video = createobject("rovideoplayer") gpio = createobject("rocontrolport", "brightsign") gpio setport(p) video setport(p) the above syntax makes use of a shortcut provided by the language the interface name is optional, unless it is needed to resolve name conflicts for example, the following two lines of code carry out the exact same function gpio setport(p) gpio ifmessageport setport(p) brightscript objects consist only of interfaces, and interfaces define only methods there is no concept of a "property" or variable at the object or interface level these must be implemented as "set" or "get" methods in an interface classes a class name is used to create a brightscript object for example, the class name for a video playback instance is rovideoplayer , so, to initialize a video playback instance, you would use code similar to the following example video = createobject("rovideoplayer") note that "video" can be any name that follows the syntax outlined in the next section object and class name syntax class names have the following characteristics must start with an alphabetic character (a – z) may consist of alphabetic characters, numbers, or the " " (i e underscore) symbol are not case sensitive may be of any reasonable length zones with the brightsign zones feature, you can divide the screen into rectangles and play different content in each rectangle depending on the brightsign model, zones can contain video, images, html content, audio, a clock, or text 4kx42, xdx32, and xdx30 models can display two video zones on screen, while the hdx22, hdx20, and lsx22 models can only display one there can be multiple zones of other types on the screen a text zone can contain simple text strings or can be configured to display an rss feed in a ticker type display as of firmware 6 0 x, zone support is enabled by default when zones are enabled, the image layer is on top of the video layer by default the default behavior can be modified using the rovideomode setgraphicszorder() method zone support can be disabled by calling enablezonesupport(false) when zones are not enabled, the image layer is hidden whenever video is played, and the video layer is hidden whenever images are played event loops when writing anything more than a very simple script, an "event loop" will need to be created event loops typically have the following structure wait for an event process the event return to step 1 an event can be any number occurrences a button has been pressed; a timer has been triggered; a udp message has been received; a video has finished playing back; etc by convention, event scripting for brightscript objects follows this work flow an object of the type romessageport is created by the script objects that can send events (i e those that support the ifmessageport/ifsetmessageport interface) are instructed to send their events to this message port using the setport() method you can set up multiple message ports and have each event go to its own message port, but it is usually simpler to create one message port and have all the events sent to this one port the script waits for an event using the built in wait() statement (or the ifmessageport waitmessage() method) if multiple object instances are assigned to the same message port, the script determines from which instance the event originated, then processes it the script then jumps back to the wait() statement example 'listens for udp messages on two different ports and displays the image file requested in the udp message body mp = createobject("romessageport") udp1 = createobject("rodatagramreceiver", 3000) udp1 setport(mp) udp1 setuserdata("port 3000") udp2 = createobject("rodatagramreceiver", 5000) udp2 setport(mp) udp2 setuserdata("port 5000") r = createobject("rorectangle",0, 0, 1920, 1080) img = createobject("roimageplayer") img setrectangle(r) loop event = wait(0, mp) if type(event) = "rodatagramevent" 	print "image play command received on " + event getuserdata() + " " 	img = displayfile("sd /" + event getstring()) 	endif endif goto loop