Entradas Nombradas
Las entradas con nombre son comandos que PlayIt Live recibe desde tus dispositivos externos. Cada entrada representa una señal o evento específico de tu 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, debes 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 con nombre correspondiente. Este activador puede ejecutar acciones a través de Activadores de entrada.
Configurar entradas con nombre
Al hacer clic en Agregar Nuevo o Editar en la sección de entradas con nombre, configuras los siguientes ajustes:
Hardware
Selecciona el dispositivo de hardware configurado que enviará este comando de entrada. El menú desplegable muestra todos los dispositivos de hardware que configuraste en la sección Hardware. Debes configurar al menos un dispositivo de hardware antes de poder crear entradas con nombre.
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 te 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 con nombre. Haz clic en Restaurar para generar automáticamente un ID único basado en el nombre de entrada que ingresaste.
Si cambias 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. Cambia 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 tu 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.
Puedes 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, escribe: \\COMMAND\r\n
Coincidencia de comandos
El comando debe coincidir exactamente para que se active la entrada. Presta 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