roDeviceCustomization

this object provides miscellaneous device configuration and customization methods iffailurereason getfailurereason() as string returns helpful information if one of the ifdevicecustomization methods fail ifdevicecustomization writesplashscreen(filename as string) as boolean removes the default splash screen (or a previously set splash screen) and replaces it with the specified image file the image file must use a image formats docid\ gzcaqroor8 zarnrepkn1 this method returns true on success and false on failure enumerateextensions() as array returns an array of the extensions that are installed on a player you will receive extension information about each listed extension, and this information will include the extension name, size, id and version if defined factoryreset(confirm as string) as boolean applies a factory reset to the player this method must be passed the string "confirm" to work; otherwise, it will return false and do nothing if successful, this method will reboot without a return value the following steps will be carried out during a factory reset all files are wiped from the boot drive (including custom splash screens and autorun scripts) all values are wiped from the registry the rtc is reset (if the player has an rtc) the flash drive is wiped configureasusbgadget(robool gadget) this method allows the usb otg (on the go) port on the au335 to be dynamically configured to host or gadget mode in the host role, the usb port follows standard behavior (it allows usb devices to be plugged into it) in the gadget role, the player can behave as a usb device (for example, rousbfilesystem) this method will return false on platforms other than the au335 this script switches to gadget role and presents sd /test img as a filesystem to a connected usb host dc=createobject("rodevicecustomization") dc configureasusbgadget(1) fs = createobject("rousbfilesystem") fs enable({filename "sd\ test img"}) if configureasusbgadget(1) isn't called on an au335, then the usb will only run in host mode, regardless of what is connected note that on all brightsign players other than au335, the usb port doesn't need any configuration to work in usb otg mode the usb stack switches automatically between host and gadget depending on what is connected to the port encryptstorage(device as string, params as roassociativearray) as boolean encrypts the contents of a storage device using an encryption key stored in the private section of the player registry this prevents other devices from reading the names or contents of files on the storage device (though file metadata will still be readable) the storage device can still be mounted on other devices, which can list, delete, and copy files (even though they cannot read them) use the device parameter to specify which storage drive to encrypt (see rostorageinfo docid\ bczooenmoifnrbeny6zki for a list of valid drive names) encryption parameters are passed as an associative array, which can contain the following method as string (required) the encryption method, which can be one of the following "none" encryption is disabled and any encryption keys for the storage device are deleted from the registry "passphrase" the storage device is encrypted using an un obfuscated passphrase "obfuscated passphrase" the storage device is encrypted using an obfuscated passphrase contact mailto\ support\@brightsign biz to learn more about generating a key for obfuscation and storing it on the player "brightsign key" the storage device is encrypted using an encryption key that is common to all brightsign players, but is not shared with outside parties "generate key" the storage device is encrypted using an encryption key that is generated on demand using a secure random generator the private registry of the player contains the only copy of the key; if the value in the registry is erased or becomes corrupted, there will be no way to recover data from that storage device note that the private registry does not distinguish between different physical volumes of the same drive for example, if you encrypt two sd cards, the key for the first sd card will be overwritten when the second sd card is encrypted; in the case of a randomly generated key, the data from the first sd card will be irretrievable passphrase as string the passphrase for encrypting the storage device this parameter must be included if the method is specified as "passphrase" or "obfuscated passphrase" format as boolean setting this parameter to true will cause the specified storage device to be reformatted–all existing files will be deleted (but are not guaranteed to be securely erased) before the device is encrypted; however, if the device cannot be reformatted, the operation will fail if this parameter is set to false , the storage device will be mounted as if it has been previously encrypted using the supplied key if the storage device hasn't been previously encrypted, it will be encrypted while leaving any preexisting files unencrypted if the storage device has been encrypted using a different key, the operation will fail if the format parameter is not specified, the storage device will be mounted as if it has been previously encrypted using the supplied key if the storage device hasn't been previously encrypted, the operation will fail