Habilita el control remoto de Brandtrack Player
Hya dos forms de controlar Brandtrack Player, de forma local y de forma remota via web o HTTP REST API, usando la aplicación de control web.
Configuración de WebControl
La aplicación WebControl abre el siguiente cuadro de diálogo de configuración cuando se inicia por primera vez:
WebControl por default, crea una llave de autenticación random y puertos de conexión. Después de habilitar WebControl por primera vez, el mismo y el Player se reiniciaran, y luego el propio Player iniciara WebControl automaticamente.
Agregar MP3
En WebControl puedes agregar archivos mp3 para reproducción manual, en tanto y en cuanto los mismo existan en el almacenamiento de la computadora. Si estos archivos existen en la computadora, pueden agregarse usando la interface de configuración.
Menu
Cuando se activa WebControl, su ícono aparecerá en la barra del sistema operativo, con las siguientes opciones habilitadas:
Abrir Portal: abre el browser con la web del portal.
Configurar: abre la ventana de diálogo de configuración
Copiar llave: copia la llave de autenticación en el bloc de notas
Portal WebControl
La web del portal, es la principal interfaz para interactuar con Brandtrack Player de forma remota, con botones de control que permiten la operación y que permite ejecutar de forma remota, también para ejecutar MP3s de tu elección. Para acceder, puedes utilizar un browser HTTP y la configuración del puerto, por ejemplo, si el puerto es62228 , la web será http://localhost:62228 en el dispositivo.
API Manual
El servidor de WebControl a las siguientes comandos de HTTP POST:
Endpoint |
Action |
/rc/fadeOut | Silencia la aplicación |
/rc/fadeIn | Restablece la reproducción |
/rc/override?index=:id | Reproducir unarchivo MP3 * |
*El ID del archivo mp3 es un integrador indexado, empezando en 0.
Llave de autenticación
Cuando esta habilitada la opción de la llave de autenticación, las llamadas HTTP deben tener un header del tipo "Authorization", por ejemplo,
Authorization: bearer d28995acc540c9a574553
Ejemplo enJavascript
var xhr = new XMLHttpRequest();
xhr.open("POST", "/rc/fadeOut", true);
xhr.setRequestHeader("Authorization", "Bearer d28995accc540c9a574553");
xhr.send();
Configuration Manual
La WebControl también puede configurarse de forma manual, editando la configuración del archivo de Brandtrack Player, que se encuentra alojado en %AppData%%Brandtrack Player.ini en Windows.
Ejemplo de configuración:
[rc]
enabled=true
webControlAutostart=true
keyEnabled=true
key=d28995acc540c9a574553
port=62228
overrides\size=3
overrides\1\name=Caja
overrides\1\path=C:/caja.mp3
overrides\2\name=Caja 2
overrides\2\path=C:/caja2.mp3
overrides\3\name=Cierre
overrides\3\path=C:/cierre.mp3
Documentación de las opciones
Nombre | Tipo de Dato | Descripción |
---|---|---|
enabled | booleano true/false | Habilita el socket local de Brandtrack Player |
webControlAutostart | booleano true/false | Inicia Brandtrack WebControl cuando se abre el Player |
keyEnabled | booleano true/false | Habilita la llave de autenticación de WebControl |
key | texto | Valor de la llave de autenticación de WebControl |
port | entero | Puerto de WebControl |
overrides | arreglo | Lista de archivos mp3 |
overrides\size | entero | Cantidad de archivos |
override\:index\name | texto | Nombre |
override\:index\path | texto | Archivo mp3 |