Entradas Nombradas
Las Entradas Nombradas son comandos que PlayIt Live recibe desde sus dispositivos externos. Cada entrada representa una señal o evento específico de su hardware, como la pulsación de un botón, la activación de un sensor o un cambio de estado.
Al crear una entrada con nombre, debe especificar:
- Hardware – El dispositivo de hardware configurado que enviará el comando.
- Nombre de entrada – Un nombre descriptivo que se muestra en PlayIt Live (p. ej., «Botón de pista siguiente»).
- ID de entrada – Un identificador único utilizado para el acceso a la API y el registro (p. ej., «BTN_NEXT»).
- Comando – La cadena de texto exacta que debe recibirse del dispositivo para activar esta entrada (p. ej.,
PLAY_NEXT\r\n).
Cuando PlayIt Live recibe datos del hardware que coinciden con la cadena de comando especificada, se activa la Entrada Nombrada correspondiente. Este activador puede ejecutar acciones a través de Activadores de entrada.
Configurar Entradas Nombradas
Al hacer clic en Agregar Nuevo o Editar en la sección de Entradas Nombradas, se configuran los siguientes ajustes:
Hardware
Seleccione el dispositivo de hardware configurado que enviará este comando de entrada. El menú desplegable muestra todos los dispositivos de hardware configurados en la sección Hardware. Debe configurar al menos un dispositivo de hardware antes de poder crear Entradas Nombradas.
Nombre de entrada
Un nombre descriptivo y legible para esta entrada que aparece en toda la interfaz de PlayIt Live. Este nombre se muestra al crear activadores de entrada y le ayuda a identificar el propósito de cada entrada.
ID de entrada
Un identificador único utilizado para hacer referencia a esta entrada en acciones de eventos programados, activadores y llamadas a la API. Debe ser único entre todas las Entradas Nombradas. Haga clic en Restaurar para generar automáticamente un ID único basado en el nombre de entrada introducido.
Si cambia el ID de entrada después de que ya esté en uso, los eventos programados existentes o los elementos del Playout Log que hagan referencia al ID de entrada anterior dejarán de funcionar y deberán actualizarse manualmente. Cambie el ID de entrada solo si es absolutamente necesario.
Configuración – Comando
El campo Comando contiene la cadena de texto exacta que debe recibirse del dispositivo de hardware para activar esta entrada. Cuando PlayIt Live recibe datos del dispositivo que coinciden con esta cadena de comando, se activa la entrada con nombre correspondiente.
Cuando su dispositivo externo (Arduino, panel de control, etc.) envía datos a PlayIt Live, esos datos se comparan con todos los comandos de entradas con nombre configurados. Si se encuentra una coincidencia, se activa la entrada y se ejecutan todos los activadores de entrada asociados.
Puede incluir secuencias de caracteres especiales para que coincidan con caracteres no imprimibles en los datos recibidos:
| Secuencia | Carácter |
|---|---|
\r | Retorno de carro (CR) |
\n | Avance de línea (LF) |
\t | Carácter de tabulación |
\\ | Barra diagonal inversa literal |
\xhh | Byte hexadecimal de 2 dígitos (p. ej., \x0D) |
\uhhhh | Carácter Unicode de 4 dígitos |
Cada barra diagonal inversa debe estar precedida de una de escape \\ al escribir. Por ejemplo, para que coincida con la cadena \COMMAND seguida de un retorno de carro y un avance de línea, escriba: \\COMMAND\r\n
Coincidencia de comandos
El comando debe coincidir exactamente para que se active la entrada. Preste especial atención a:
- Mayúsculas y minúsculas (la mayoría de los sistemas distinguen entre mayúsculas y minúsculas)
- Finales de línea (
\r\nvs.\nvs. ninguno) - Caracteres de espacio en blanco
- Caracteres especiales o secuencias de escape