roDeviceCustomization
Este objeto proporciona diversos métodos de configuración y personalización del dispositivo.
ifFailureReason
GetFailureReason() As String
Devuelve información útil si uno de los métodos ifDeviceCustomization falla.
ifDeviceCustomization
WriteSplashScreen(filename As String) As Boolean
Elimina la pantalla de presentación predeterminada (o una pantalla de presentación configurada previamente) y la reemplaza con el archivo de imagen especificado. El archivo de imagen debe usar un formato de imagen compatible. Este método devuelve Verdadero en caso de éxito y Falso en caso de error.
EnumerateExtensions() As Array
Devuelve una matriz de las extensiones instaladas en un reproductor. Recibirá información de extensión sobre cada extensión listada, y esta información incluirá el nombre, tamaño, id y versión de la extensión si están definidos.
FactoryReset(confirm As String) As Boolean
Aplica un restablecimiento de fábrica al reproductor. Debe pasarse a este método la cadena "confirm" para que funcione; de lo contrario, devolverá Falso y no hará nada. Si tiene éxito, este método reiniciará sin un valor de retorno. Los siguientes pasos se llevarán a cabo durante un restablecimiento de fábrica:
- Todos los archivos se eliminan de la unidad ARRANQUE: (incluidas las pantallas de presentación personalizadas y los scripts de autorun).
- Todos los valores se eliminan del registro.
- El RTC se restablece (si el reproductor tiene un RTC).
- La unidad ÚLTIMA HORA: se elimina.
ConfigureAsUsbGadget(roBool gadget)
Este método permite que el puerto USB OTG (On The Go) en el AU335 se configure dinámicamente en modo anfitrión o dispositivo . En el rol de anfitrión , el puerto USB sigue el comportamiento estándar (permite conectar dispositivos USB en él). En el rol de dispositivo , el reproductor puede comportarse como un dispositivo USB (por ejemplo, roUsbFilesystem). Este método devolverá false en plataformas distintas de AU335.
Este script cambia al rol dispositivo y presenta sd:/test.img como un sistema de archivos a un host USB conectado:
dc=CreateObject("roDeviceCustomization")
dc.ConfigureAsUsbGadget(1)
fs = CreateObject("roUsbFilesystem")
fs.Enable({filename: "SD:test.img"})Si no se llama a ConfigureAsUsbGadget(1) en un AU335, entonces el USB solo se ejecutará en modo anfitrión , independientemente de lo que esté conectado.
Tenga en cuenta que en todos los reproductores BrightSign distintos del AU335, el puerto USB no necesita ninguna configuración para funcionar en modo USB OTG. La pila USB cambia automáticamente entre anfitrión y dispositivo dependiendo de lo que esté conectado al puerto.
EncryptStorage(device As String, params As roAssociativeArray) As Boolean
Cifra el contenido de un dispositivo de almacenamiento utilizando una clave de cifrado almacenada en la sección privada del registro del reproductor. Esto evita que otros dispositivos lean los nombres o contenidos de los archivos en el dispositivo de almacenamiento (aunque los metadatos de los archivos seguirán siendo legibles). El dispositivo de almacenamiento todavía puede montarse en otros dispositivos, que pueden listar, eliminar y copiar archivos (aunque no puedan leerlos).
Use el parámetro dispositivo para especificar qué unidad de almacenamiento cifrar (consulte aquíhere para obtener una lista de nombres de unidades válidos). Los parámetros de cifrado se pasan como una matriz asociativa, que puede contener lo siguiente:
- method As String:(Obligatorio) El método de cifrado, que puede ser uno de los siguientes:
- "ninguno": El cifrado está deshabilitado y cualquier clave de cifrado para el dispositivo de almacenamiento se elimina del registro.
- "frase de contraseña": El dispositivo de almacenamiento se cifra utilizando una frase de contraseña no ofuscada.
- "obfuscated_passphrase": El dispositivo de almacenamiento se cifra utilizando una frase de contraseña ofuscada. Contacte con [email protected] para obtener más información sobre cómo generar una clave para la ofuscación y almacenarla en el reproductor.
- "brightsign_key": El dispositivo de almacenamiento se cifra utilizando una clave de cifrado que es común a todos los reproductores BrightSign, pero no se comparte con terceros.
- "generate_key": El dispositivo de almacenamiento se cifra utilizando una clave de cifrado que se genera bajo demanda utilizando un generador aleatorio seguro. El registro privado del reproductor contiene la única copia de la clave; si el valor en el registro se elimina o se corrompe, no habrá forma de recuperar los datos de ese dispositivo de almacenamiento.
- Tenga en cuenta que el registro privado no distingue entre diferentes volúmenes físicos de la misma unidad. Por ejemplo, si cifra dos tarjetas SD, la clave de la primera tarjeta SD se sobrescribirá cuando se cifre la segunda tarjeta SD; en el caso de una clave generada aleatoriamente, los datos de la primera tarjeta SD no podrán recuperarse.
- frase de contraseña como cadena: La frase de contraseña para cifrar el dispositivo de almacenamiento. Este parámetro debe incluirse si el método se especifica como "frase de contraseña" o "obfuscated_passphrase".
- formato como booleano: Establecer este parámetro en verdadero hará que el dispositivo de almacenamiento especificado se vuelva a formatear: todos los archivos existentes se eliminarán (pero no se garantiza que se borren de forma segura) antes de que se cifre el dispositivo; sin embargo, si el dispositivo no puede volver a formatearse, la operación fallará. Si este parámetro se establece en falso, el dispositivo de almacenamiento se montará como si hubiera sido cifrado previamente utilizando la clave proporcionada.
- Si el dispositivo de almacenamiento no ha sido cifrado previamente, se cifrará dejando sin cifrar cualquier archivo preexistente. Si el dispositivo de almacenamiento ha sido cifrado utilizando una clave diferente, la operación fallará.
- Si el parámetro formato no se especifica, el dispositivo de almacenamiento se montará como si hubiera sido cifrado previamente utilizando la clave proporcionada. Si el dispositivo de almacenamiento no ha sido cifrado previamente, la operación fallará.