Clawtronics: Neue technische Referenz zu Init- und Zustandsmeldungen

2026-08-05T05:53:52Z

Neue technische Referenz zu Init- und Zustandsmeldungen

Neue Seite

= Client-Feedback und Stationsmeldungen =

== Zweck ==

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 ==

* 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 ==

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 ==

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

<code><Schlüsselwort>: <Stationsnummer></code>

{| class="wikitable"
! Beispiel
! Wirkung
|-
| <code>idle: 1021</code> || Die Station wird als frei markiert.
|-
| <code>touchscreen: 1021</code> || Die Station wird als lokal über den Touchscreen benutzt markiert.
|-
| <code>open: 1021</code> || 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 ==

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

== Funktionsprüfung ==

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

== Typische Fehler ==

{| class="wikitable"
! 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 ==

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]].

[[Kategorie:MegBes]]
[[Kategorie:Schnittstellen]]
[[Kategorie:Fehlerdiagnose]]

Client-Feedback und Stationsmeldungen - Versionsgeschichte

Clawtronics: Neue technische Referenz zu Init- und Zustandsmeldungen