Ingressi Nominati
Gli Ingressi Nominati sono comandi che PlayIt Live riceve dai dispositivi esterni. Ogni ingresso rappresenta un segnale o un evento specifico dell'hardware, come la pressione di un pulsante, l'attivazione di un sensore o un cambio di stato.
Quando si crea un Ingresso Nominato, è necessario specificare:
- Hardware – Il dispositivo hardware configurato che invierà il comando.
- Nome Ingresso – Un nome descrittivo visualizzato in PlayIt Live (es. «Pulsante pista successiva»).
- ID Ingresso – Un identificatore univoco utilizzato per l'accesso all'API e la registrazione (es. «BTN_NEXT»).
- Comando – La stringa di testo esatta che deve essere ricevuta dal dispositivo per attivare questo ingresso (es.
PLAY_NEXT\r\n).
Quando PlayIt Live riceve dati dall'hardware che corrispondono alla stringa di comando specificata, viene attivato il corrispondente Ingresso Nominato. Questo trigger può quindi eseguire azioni tramite i Trigger di ingresso.
Configurare gli Ingressi Nominati
Facendo clic su Aggiungi Nuovo o Modifica nella sezione Ingressi Nominati, si configurano le seguenti impostazioni:
Hardware
Selezionare il dispositivo hardware configurato che invierà questo comando di ingresso. L'elenco a discesa mostra tutti i dispositivi hardware configurati nella sezione Hardware. È necessario configurare almeno un dispositivo hardware prima di poter creare Ingressi Nominati.
Nome Ingresso
Un nome descrittivo e leggibile per questo ingresso che viene visualizzato nell'intera interfaccia di PlayIt Live. Questo nome viene visualizzato durante la creazione di trigger di ingresso e consente di identificare lo scopo di ciascun ingresso.
ID Ingresso
Un identificatore univoco utilizzato per fare riferimento a questo ingresso nelle azioni degli eventi programmati, nei trigger e nelle chiamate API. Deve essere univoco tra tutti gli Ingressi Nominati. Fare clic su Ripristina per generare automaticamente un ID univoco basato sul nome ingresso inserito.
Se si modifica l'ID ingresso dopo che è già in uso, gli eventi programmati esistenti o gli elementi del Playout Log che fanno riferimento al vecchio ID ingresso non funzioneranno più e dovranno essere aggiornati manualmente. Modificare l'ID ingresso solo se assolutamente necessario.
Configurazione – Comando
Il campo Comando contiene la stringa di testo esatta che deve essere ricevuta dal dispositivo hardware per attivare questo ingresso. Quando PlayIt Live riceve dati dal dispositivo corrispondenti a questa stringa di comando, viene attivato il corrispondente Ingresso Nominato.
Quando il dispositivo esterno (Arduino, pannello di controllo, ecc.) invia dati a PlayIt Live, questi vengono confrontati con tutti i comandi degli Ingressi Nominati configurati. Se viene trovata una corrispondenza, l'ingresso viene attivato e vengono eseguiti tutti i trigger di ingresso associati.
È possibile includere sequenze di caratteri speciali per corrispondere a caratteri non stampabili nei dati ricevuti:
| Sequenza | Carattere |
|---|---|
\r | Ritorno a capo (CR) |
\n | Avanzamento riga (LF) |
\t | Carattere di tabulazione |
\\ | Barra rovesciata letterale |
\xhh | Byte esadecimale a 2 cifre (es. \x0D) |
\uhhhh | Carattere Unicode a 4 cifre |
Ogni barra rovesciata deve essere preceduta da un carattere di escape \\ durante la digitazione. Ad esempio, per corrispondere alla stringa \COMMAND seguita da un ritorno a capo e un avanzamento riga, digitare: \\COMMAND\r\n
Corrispondenza dei comandi
Il comando deve corrispondere esattamente affinché l'ingresso venga attivato. Prestare attenzione a:
- Maiuscole e minuscole (la maggior parte dei sistemi distingue tra maiuscole e minuscole)
- Fine riga (
\r\nvs\nvs nessuna) - Caratteri spazio
- Caratteri speciali o sequenze di escape