Zum Inhalt springen

Client-Feedback und Stationsmeldungen

Aus MegBes Wiki
Version vom 5. August 2026, 05:53 Uhr von Clawtronics (Diskussion | Beiträge) (Neue technische Referenz zu Init- und Zustandsmeldungen)
(Unterschied) ← Nächstältere Version | Aktuelle Version (Unterschied) | Nächstjüngere Version → (Unterschied)

Client-Feedback und Stationsmeldungen

[Bearbeiten]

Zweck

[Bearbeiten]

Medienstationen können ihren Start und – bei stationsgesteuerten Projekten – ihren aktuellen Nutzungszustand per UDP an `megbes-internal` melden. Diese Rückmeldungen ermöglichen Betriebsinformationen und verhindern, dass zwei Bedienwege dieselbe Station gleichzeitig übernehmen.

Voraussetzungen

[Bearbeiten]
  • Die Medienstation erreicht den lokalen Server im Ausstellungsnetz.
  • Zieladresse und UDP-Port entsprechen der Projektkonfiguration.
  • Bei Nutzung von Stationszuständen ist der stationsgesteuerte Modus auf interner und externer Ebene aktiviert.
  • Die Stationsnummer stimmt mit der Projektkonfiguration überein.

Init-Meldung

[Bearbeiten]

Eine Nachricht, die mit `init` beginnt, wird als Start- oder Informationsmeldung verarbeitet. Der nachfolgende Text kann Geräte- oder Startinformationen enthalten. Abhängig von der Projektkonfiguration kann daraus eine Informationsmail erzeugt werden.

Die Init-Meldung bestätigt, dass der UDP-Sender der Station den lokalen Server grundsätzlich erreicht. Sie bestätigt noch nicht, dass Steuerbefehle in Gegenrichtung bei der Station ankommen.

Zustandsmeldungen

[Bearbeiten]

Bei stationsgesteuerten Projekten erwartet der aktuelle Code Meldungen nach dem Muster:

<Schlüsselwort>: <Stationsnummer>
Beispiel Wirkung
idle: 1021 Die Station wird als frei markiert.
touchscreen: 1021 Die Station wird als lokal über den Touchscreen benutzt markiert.
open: 1021 Die Station wird unabhängig von der üblichen Belegungsprüfung als offen markiert.

Der Zustand `REMOTE` wird von der Anwendung bei erfolgreicher Übernahme durch einen entfernten Benutzer gesetzt. Er ist in der aktuellen Empfangslogik keine gleichartige UDP-Rückmeldung der Station.

Lebenszyklus einer stationsgesteuerten Nutzung

[Bearbeiten]
  1. Die Station meldet `idle` und ist damit verfügbar.
  2. Ein entfernter Benutzer fordert die Station an.
  3. `megbes-internal` prüft den Zustand und ordnet die Station bei erfolgreicher Übernahme dem Benutzer zu.
  4. Steuerbefehle dieses Benutzers aktualisieren den letzten Nutzungszeitpunkt.
  5. Nach Ende der lokalen Wiedergabe meldet die Station wieder `idle`.
  6. Bleibt eine Rückmeldung aus, greift nach dem projektspezifisch konfigurierten Zeitraum die Fallback-Logik gegen dauerhaft blockierte Stationen.

Funktionsprüfung

[Bearbeiten]
  1. Die Station beziehungsweise den UDP-Sender starten.
  2. Im Log von `megbes-internal` prüfen, ob die Init-Meldung empfangen wird.
  3. Eine Zustandsmeldung mit der korrekten Stationsnummer auslösen.
  4. Den Stationsstatus über den vorgesehenen Bedienweg abfragen.
  5. Eine Fernübernahme testen und anschließend sicherstellen, dass die Station wieder `idle` meldet.

Typische Fehler

[Bearbeiten]
Fehlerbild Prüfung
Keine Init-Meldung im Log Ziel-IP, UDP-Port, lokale Firewall und Netzwerkverbindung prüfen. Meldung kommt an, Status ändert sich nicht Schlüsselwort, Doppelpunkt, Leerzeichen und Stationsnummer mit dem erwarteten Format vergleichen. Falsche Station ändert ihren Zustand Stationsnummer in Stationssoftware und Projektkonfiguration prüfen. Station bleibt belegt Prüfen, ob nach Wiedergabeende tatsächlich `idle` gesendet wird; danach den projektspezifischen Timer prüfen. Lokale Nutzung wird nicht erkannt Prüfen, ob beim Start der lokalen Touchscreen-Nutzung `touchscreen` gesendet wird.

Sicherheit und Dokumentation

[Bearbeiten]

Empfängeradressen, Ports und Stationsnummern sind projektspezifisch und werden auf der Projektseite dokumentiert. Geheimwerte gehören nicht in Beispielskripte oder Wiki-Seiten. Änderungen am Nachrichtenformat müssen mit der eingesetzten Stationssoftware und dem installierten MegBes-Release abgestimmt werden.

Siehe auch UDP und Stationszustände und Routing und Signalweg.