Entrées nommées
Les entrées nommées sont des commandes que PlayIt Live reçoit depuis vos périphériques externes. Chaque entrée représente un signal ou un événement spécifique de votre matériel, comme l'appui sur un bouton, l'activation d'un capteur ou un changement d'état.
Lorsque vous créez une entrée nommée, vous spécifiez :
- Matériel – Le périphérique matériel configuré qui enverra la commande.
- Nom de l'entrée – Un nom descriptif affiché dans PlayIt Live (p. ex. « Bouton piste suivante »).
- ID d'entrée – Un identifiant unique utilisé pour l'accès à l'API et la journalisation (p. ex. « BTN_NEXT »).
- Commande – La chaîne de texte exacte qui doit être reçue du périphérique pour déclencher cette entrée (p. ex.
PLAY_NEXT\r\n).
Lorsque PlayIt Live reçoit des données du matériel correspondant à la chaîne de commande spécifiée, l'entrée nommée correspondante est déclenchée. Ce déclencheur peut ensuite exécuter des actions via les Déclencheurs d'entrée.
Configurer les entrées nommées
Lorsque vous cliquez sur Ajouter Nouveau ou Modifier dans la section Entrées nommées, vous configurez les paramètres suivants :
Matériel
Sélectionnez le périphérique matériel configuré qui enverra cette commande d'entrée. La liste déroulante affiche tous les périphériques matériels que vous avez configurés dans la section Matériel. Vous devez configurer au moins un périphérique matériel avant de pouvoir créer des entrées nommées.
Nom de l'entrée
Un nom descriptif et lisible pour cette entrée qui apparaît dans toute l'interface de PlayIt Live. Ce nom est affiché lors de la création de déclencheurs d'entrée et vous aide à identifier l'objectif de chaque entrée.
ID d'entrée
Un identifiant unique utilisé pour référencer cette entrée dans les actions d'événements planifiés, les déclencheurs et les appels API. Doit être unique parmi toutes les entrées nommées. Cliquez sur Restaurer pour générer automatiquement un ID unique basé sur le nom d'entrée saisi.
Si vous modifiez l'ID d'entrée après qu'il est déjà utilisé, les événements planifiés existants ou les éléments du Playout Log référençant l'ancien ID d'entrée ne fonctionneront plus et devront être mis à jour manuellement. Ne modifiez l'ID d'entrée que si cela est absolument nécessaire.
Configuration – Commande
Le champ Commande contient la chaîne de texte exacte qui doit être reçue du périphérique matériel pour déclencher cette entrée. Lorsque PlayIt Live reçoit des données du périphérique correspondant à cette chaîne de commande, l'entrée nommée correspondante est déclenchée.
Lorsque votre périphérique externe (Arduino, panneau de contrôle, etc.) envoie des données à PlayIt Live, ces données sont comparées à toutes les commandes d'entrées nommées configurées. Si une correspondance est trouvée, l'entrée est déclenchée et tous les déclencheurs d'entrée associés sont exécutés.
Vous pouvez inclure des séquences de caractères spéciaux pour correspondre aux caractères non imprimables dans les données reçues :
| Séquence | Caractère |
|---|---|
\r | Retour chariot (CR) |
\n | Saut de ligne (LF) |
\t | Caractère de tabulation |
\\ | Barre oblique inverse littérale |
\xhh | Octet hexadécimal à 2 chiffres (p. ex. \x0D) |
\uhhhh | Caractère Unicode à 4 chiffres |
Chaque barre oblique inverse doit être échappée en \\ lors de la saisie. Par exemple, pour correspondre à la chaîne \COMMAND suivie d'un retour chariot et d'un saut de ligne, saisissez : \\COMMAND\r\n
Correspondance des commandes
La commande doit correspondre exactement pour que l'entrée soit déclenchée. Soyez attentif à :
- La casse (la plupart des systèmes sont sensibles à la casse)
- Les fins de ligne (
\r\nvs\nvs aucune) - Les espaces blancs
- Les caractères spéciaux ou séquences d'échappement