Benannte Eingänge
Benannte Eingänge sind Befehle, die PlayIt Live von Ihren externen Geräten empfängt. Jeder Eingang stellt ein bestimmtes Signal oder Ereignis von Ihrer Hardware dar, z. B. einen Tastendruck, eine Sensoraktivierung oder eine Statusänderung.
Wenn Sie einen benannten Eingang erstellen, geben Sie Folgendes an:
- Hardware – Welches konfigurierte Hardwaregerät den Befehl sendet.
- Eingangsname – Ein beschreibender Name, der in PlayIt Live angezeigt wird (z. B. „Nächster Track-Schalter").
- Eingangs-ID – Ein eindeutiger Bezeichner, der für den API-Zugriff und die Protokollierung verwendet wird (z. B. „BTN_NEXT").
- Befehl – Die genaue Textzeichenfolge, die vom Gerät empfangen werden muss, um diese Eingabe auszulösen (z. B.
PLAY_NEXT\r\n).
Wenn PlayIt Live Daten von der Hardware empfängt, die mit der angegebenen Befehlszeichenfolge übereinstimmen, wird der entsprechende benannte Eingang ausgelöst. Dieser Auslöser kann dann Aktionen über Eingangstrigger ausführen.
Benannte Eingänge konfigurieren
Wenn Sie im Bereich „Benannte Eingänge" auf Neu Hinzufügen oder Bearbeiten klicken, konfigurieren Sie die folgenden Einstellungen:
Hardware
Wählen Sie aus, welches konfigurierte Hardwaregerät diesen Eingabebefehl senden soll. Das Dropdown-Menü listet alle Hardwaregeräte auf, die Sie im Bereich „Hardware" konfiguriert haben. Sie müssen mindestens ein Hardwaregerät konfigurieren, bevor Sie benannte Eingänge erstellen können.
Eingangsname
Ein beschreibender, für Menschen lesbarer Name für diesen Eingang, der in der gesamten Benutzeroberfläche von PlayIt Live angezeigt wird. Dieser Name wird beim Erstellen von Eingangstriggers angezeigt und hilft Ihnen, den Zweck jedes Eingangs zu identifizieren.
Eingangs-ID
Ein eindeutiger Bezeichner, mit dem auf diesen Eingang in Aktionen für geplante Ereignisse, Auslösern und API-Aufrufen verwiesen wird. Muss für alle benannten Eingänge eindeutig sein. Klicken Sie auf Zurücksetzen, um automatisch eine eindeutige ID basierend auf dem eingegebenen Eingangsnamen zu generieren.
Wenn Sie die Eingangs-ID ändern, nachdem sie bereits verwendet wird, funktionieren alle vorhandenen geplanten Ereignisse oder Playout-Log-Einträge, die auf die alte Eingangs-ID verweisen, nicht mehr und müssen manuell aktualisiert werden. Ändern Sie die Eingangs-ID nur, wenn es unbedingt erforderlich ist.
Konfiguration – Befehl
Das Befehlsfeld enthält die genaue Textzeichenfolge, die vom Hardwaregerät empfangen werden muss, um diese Eingabe auszulösen. Wenn PlayIt Live Daten vom Gerät empfängt, die mit dieser Befehlszeichenfolge übereinstimmen, wird die entsprechende benannte Eingabe ausgelöst.
Wenn Ihr externes Gerät (Arduino, Bedienfeld usw.) Daten an PlayIt Live sendet, werden diese Daten mit allen konfigurierten Befehlen für benannte Eingänge verglichen. Wird eine Übereinstimmung gefunden, wird der Eingang ausgelöst und alle zugehörigen Eingangstriggers werden ausgeführt.
Sie können spezielle Zeichensequenzen einschließen, um nicht druckbare Zeichen in den empfangenen Daten zu erfassen:
| Sequenz | Zeichen |
|---|---|
\r | Wagenrücklauf (CR) |
\n | Zeilenvorschub (LF) |
\t | Tabulatorzeichen |
\\ | Literaler Backslash |
\xhh | 2-stelliges hexadezimales Byte (z. B. \x0D) |
\uhhhh | 4-stelliges Unicode-Zeichen |
Jeder Backslash muss bei der Eingabe als \\ maskiert werden. Um beispielsweise die Zeichenfolge \COMMAND gefolgt von einem Wagenrücklauf und Zeilenvorschub zu erfassen, geben Sie ein: \\COMMAND\r\n
Befehlsabgleich
Der Befehl muss genau übereinstimmen, damit die Eingabe ausgelöst wird. Achten Sie besonders auf:
- Groß-/Kleinschreibung (die meisten Systeme unterscheiden zwischen Groß- und Kleinschreibung)
- Zeilenenden (
\r\nvs.\nvs. keine) - Leerzeichen
- Sonderzeichen oder Escape-Sequenzen