Depuración de páginas web
Web Inspector
Puede usar el Web Inspector para depurar páginas web a través de la red local.
La consola JavaScript solo debe usarse en presentaciones que no sean de producción y debe deshabilitarse antes de publicar en un entorno de producción porque usa más memoria, lo que puede provocar reinicios frecuentes y compromete la seguridad.
Habilitación/deshabilitación de Web Inspector
A partir de BOS versión 8.5.31 y posteriores, ambas configuraciones, una de presentación y otra de registro (la clave de registro habilitar_inspector_web en la sección html), son necesarias para habilitar Web Inspector. A continuación se describen los diversos métodos que puede usar para habilitar estas configuraciones.
Mediante la configuración de presentación:
- BrightSign Author: En su presentación de BrightSign Author, vaya a Pestaña de presentación > Propiedades del estado > Opciones y seleccione Habilitar la consola de JavaScript.
- BrightAuthor Classic: En su presentación de BrightAuthor Classic, vaya a Archivo > Propiedades de la presentación > HTML y marque la casilla Habilitar la consola de JavaScript . Consulte "inspector_server" en roHtmlWidget para obtener más información.
- BrightScript: Al crear la instancia de roHtmlWidget , incluya el parámetro de inicialización inspector_server y especifique un número de puerto.
Mediante la configuración del registro:
Estas configuraciones solo son necesarias a partir de BOS versión 8.5.31 y posteriores.
- DWS local/remoto: Seleccione Permitir la consola de JavaScript en la sección Depuración de Chromium del DWS.
- APIs de DWS local: Establezca PUT /v1/diagnostics/chromium-debug/ en verdadero para habilitar Web Inspector. Consulte esta página para obtener más información.
- BrightScript: Establezca la clave de registro habilitar_inspector_web en “1” para habilitar Web Inspector para Chromium en el reproductor (si se establece en “0” o en nada, Web Inspector estará deshabilitado). Por ejemplo:
reg = CreateObject("roRegistrySection","html")
reg.Write("enable_web_inspector", "1")
reg.Flush()Para deshabilitar Web Inspector, deshabilite la configuración de presentación o de registro que usó para habilitarlo.
Si quiere cambiar el puerto de Web Inspector, debe editar la configuración de roHtmlWidget. Consulte "inspector_server" en roHtmlWidget para obtener más información.
Habilitar Web Inspector crea una vulnerabilidad de seguridad en los reproductores BrightSign. Consulte esta página para obtener más detalles.
Inspección de una página web
Una vez que el contenido HTML se esté ejecutando en un reproductor BrightSign, siga estos pasos para inspeccionarlo:
- Abra Chrome en una computadora de escritorio conectada a la misma red local.
- Introduzca la siguiente URL en la barra de direcciones: chrome://inspect/devices
- En la sección Dispositivos , haga clic en Configurar.
- Introduzca la dirección IP del reproductor y el puerto de Web Inspector en el campo (consulte la imagen a continuación). Las páginas que se estén ejecutando en el reproductor BrightSign se mostrarán en la parte inferior de la página.
- Si no conoce la dirección IP del reproductor, encienda el reproductor con la tarjeta microSD (y otros dispositivos de almacenamiento) retirados. Después de unos momentos, la dirección IP se mostrará en pantalla.
- Si habilitó el Web Inspector en BrightAuthor, use el puerto 2999 (p. ej. http://192.168.1.62:2999/).
- Haga clic en el botón Inspeccionar junto a una página. Se iniciará una sesión de depuración en una nueva ventana. A diferencia de las páginas locales, el contenido de la página no se muestra en el panel izquierdo, pero la ventana del inspector de la derecha puede utilizarse para depurar la página.
Agregar más de un dispositivo en su lista puede causar problemas de rendimiento, especialmente si los dispositivos no están en línea, porque el cliente de Chrome continuará buscando cualquier dispositivo fuera de línea.
Compatibilidad de versiones de Chromium
Debido a que los reproductores BrightSign usan una versión más antigua de Chromium que las versiones recientes de escritorio, es posible que las versiones más nuevas de Chrome para escritorio no funcionen con el Web Inspector. Si tiene problemas al usar el Web Inspector con su versión de Chrome, descargue e instale una de estas versiones:
Si está utilizando el Web Inspector para recorrer manualmente código JavaScript, encontrar un error no capturado en el depurador puede causar que el reproductor falle. Este es un error conocido del Web Inspector.
Puede encontrar una colección más amplia de descargas compatibles de Chromium aquí.
Eventos de seguimiento
El sistema Chromium TraceEvent le permite depurar pérdidas de memoria de JavaScript, problemas de rendimiento y problemas de renderizado. Esta función está disponible en las versiones de firmware 7.0.82 y posteriores. A diferencia de las PC, donde el seguimiento/depurador se ejecuta en el mismo navegador que el contenido, los reproductores BrightSign escriben archivos de seguimiento JSON en el almacenamiento local, que luego puede importar a Chrome en su PC.
Cuando los eventos de seguimiento están habilitados en un reproductor BrightSign, Chromium captura mensajes de seguimiento en un búfer circular. El reproductor toma instantáneas periódicas de este búfer y las escribe en el directorio raíz de la tarjeta microSD o SSD como archivos JSON.
El sistema TraceEvent puede generar fácilmente gigabytes de datos de registro en el almacenamiento local, por lo que recomendamos deshabilitarlo en entornos de producción.
Consulte esta página de StackOverflow para obtener más información sobre pérdidas de memoria al usar console.log para registrar objetos complejos.
Creación de un directorio TraceEvent
Antes de habilitar el sistema TraceEvent, cree un directorio llamado "brightsign-webinspector" en el directorio raíz de la tarjeta microSD o SSD del reproductor. Si falta este directorio, el reproductor no registrará eventos de seguimiento cuando estén habilitados en el registro. Por el contrario, puede deshabilitar los eventos de seguimiento eliminando el directorio "brightsign-webinspector" del dispositivo de almacenamiento.
Habilitación del sistema TraceEvent
El sistema TraceEvent se habilita y configura escribiendo en el registro del reproductor BrightSign (mediante BrightScript o JavaScript). Para habilitar el sistema TraceEvent, escriba las siguientes claves en la sección html del registro:
- tracecategories string: Una lista separada por comas de categorías de eventos de seguimiento para habilitar. Los nombres de las categorías están documentados en el enlace a continuación.
- tracemaxsnapshots int: El número máximo de archivos de instantáneas de seguimiento JSON en el directorio "brightsign-webinspector". Cuando se alcanza el límite, el contador vuelve al inicio y comienza a sobrescribir el archivo de seguimiento más antiguo.
- tracemonitorinterval int: La frecuencia (en segundos) con la que el reproductor tomará instantáneas del búfer TraceEvent. Recomendamos 60 segundos como valor predeterminado.
Ejemplo (JavaScript):
var registryClass = require("@brightsign/registry");
var registry = new registryClass();
registry.write("html", {
"tracecategories": "toplevel,blink_gc,disabled-by-default-memory-infra,disabled-by-default-blink_gc,disabled-by-default.skia.gpu.cache",
"tracemaxsnapshots": "25",
"tracemonitorinterval": "60"
}).then(
function() {
console.log("Write Successful");
});Visualización de eventos de rastreo
Siga estos pasos para ver los eventos de rastreo:
- Transfiera los archivos de rastreo JSON del directorio "brightsign-webinspector" a su PC.
- Abra chrome://tracing en su instancia de Chromium en el PC.
- Importe los archivos de rastreo JSON.
Puede combinar varios archivos de rastreo; sin embargo, en una captura de rastreo larga, habrá demasiados eventos de rastreo para verlos todos a la vez (probablemente necesitará escribir un script para procesarlos).
Documentación adicional
Consulte los siguientes enlaces para obtener una explicación más detallada de los eventos de rastreo: