Kamerakontrolle · Simulator und Bild-Upload

1. Zweck und Grenzen

Die lokale Kamerastation liest farbige Magnete auf einer kalibrierten 0–13-Skala. Zunächst stehen Simulator (fest oder PTZ) und Bild-Upload bereit. Echte Kameras, RTSP, USB, ONVIF und Videodateien sind Erweiterungspunkte und noch nicht angebunden. Die vorliegenden Hallenfotos erfordern eine Kalibrierung je Tafel; eine allgemeine automatische Tafelerkennung ist nicht zugesichert.

Standard ist die manuelle Bestätigung. Eine reine Erkennung ändert keinen Spielstand. Auch eine übertragene Kamerameldung ist nur die Meldung einer Mannschaftsseite und ersetzt keine Endergebnisbestätigung.

2. Installation am Hallenrechner

Das Projektverzeichnis auf einen Mac oder Windows-Rechner mit Python 3.12 oder neuer kopieren. Im Terminal im Projektverzeichnis folgende Befehle verwenden:

python3 -m venv .venv-camera
# macOS:
.venv-camera/bin/python -m pip install -r requirements-camera.txt
.venv-camera/bin/python -m camera_station
# Windows (Python-Launcher):
py -3 -m venv .venv-camera
.venv-camera\Scripts\python -m pip install -r requirements-camera.txt
.venv-camera\Scripts\python -m camera_station

Beim Start eine lokale Stations-PIN mit mindestens acht Zeichen festlegen. Anschließend http://127.0.0.1:8765 auf demselben Rechner öffnen und entsperren. Diese PIN schützt nur den lokalen Bedienplatz; die Anmeldung am SBV-Portal bleibt unverändert. Der Dienst bindet ausschließlich an die lokale Loopback-Adresse. Mit Strg+C beenden.

3. Ohne Turnieränderungen testen

1. Beim Start ohne Gerätezugang bleiben alle Erkennungen lokal. Im Simulator die Werte ändern oder Magnete verdecken.
2. „Erneut prüfen“ wählen. Aktuelles Bild, ausgewertetes Bild und markierten Tafelausschnitt vergleichen.
3. Mit „Bild hochladen“ JPEG, PNG oder HEIC wählen. Ein Upload ist ein Einzelbild, kein Livebild. Sein Zeitstempel bezeichnet den Upload, keine nachgewiesene Kamera-Aufnahmezeit. Für mehrere Tafeln im selben Foto weitere Tafeln anlegen und getrennte Ausschnitte kalibrieren. Bei fortgesetzter Prüfung werden die Tafeln der Reihe nach ausgewertet.
4. Vor einem neuen Upload pausieren. Nach Kalibrierung erneut prüfen. Fehlende, verdeckte, doppelte oder zwischen zwei Zahlen liegende Magnete werden als unklar angezeigt.

4. Kalibrierung und Datenschutz

Unter „Tafel, Partie und Kalibrierung“ zunächst den Ausschnitt auf die Tafel begrenzen. Alle Koordinaten liegen zwischen 0 und 1. Anschließend je Heim/Gast die X-Position der Magnetspur, die Y-Position bei 0 und 13 Punkten und den Farbton einstellen (Grün ungefähr 140°, Gelb ungefähr 50°). Diese Koordinaten beziehen sich auf den Ausschnitt. Bei blassen Magneten kann die minimale Farbsättigung abgesenkt werden; dabei auf zusätzliche Fehlmarkierungen achten. Bei schrägen Tafeln die beiden Skalen getrennt einstellen. Die Zuordnung der Farben zu Heim/Gast muss vor Ort geprüft werden.

Vollständige Hallenbilder bleiben ausschließlich im Arbeitsspeicher und werden weder als Video aufgezeichnet noch veröffentlicht. Erst bei einer Ergebnisfreigabe wird der konfigurierte Tafelausschnitt lokal gespeichert. Standardaufbewahrung sieben Tage, einstellbar auf 1–30 Tage. Nur wirklich notwendige Tafelausschnitte wählen. Das Hauptprogramm erhält Ereignisdaten und Beleg-Prüfsumme; Bildbelege verbleiben lokal.

5. Gerät autorisieren (Admin)

1. Im Portal unter Turniere → Kamerakontrolle eine Station mit Namen, Heim/Gast-Seite und ausdrücklich erlaubten Partien anlegen. Fernsteuerung und automatische Freigabe sind getrennte Optionen.
2. Den einmalig angezeigten Gerätezugang vertraulich übernehmen. Am Hallenrechner den Startbefehl um --pair ergänzen und den Zugang unsichtbar eingeben.
3. Der Zugang wird im macOS-Schlüsselbund beziehungsweise Windows-Anmeldeinformationsspeicher abgelegt. Ohne unterstützten nativen Speicher gibt es keine unverschlüsselte Ersatzablage.
4. In der lokalen Tafelkonfiguration die richtige Partie auswählen. Runde, Bahn, Mannschaften und Seite sorgfältig prüfen. Der Spielstart erfolgt weiterhin durch die Mannschaften.
5. Bei Verlust oder Wechsel des Rechners den alten Gerätezugang im Portal widerrufen und eine neue Station autorisieren.

Änderungen an Auslosung, Turnierkonfiguration oder Spielplan können die Gerätefreigabe ungültig machen. Dann neu autorisieren und zuordnen. Alte Ereignisse behalten ihre ursprüngliche Partie.

6. Ergebnisse prüfen und übertragen

Die Bestätigung bezieht sich auf genau das angezeigte ausgewertete Einzelbild. Heim/Gast prüfen, bei Bedarf korrigieren und den eigenen Namen eingeben. Der eingegebene Name ist eine lokale Selbstauskunft; die serverseitige Autorisierung erfolgt über die Geräteidentität. Bei Unsicherheit verwerfen oder neu prüfen. Eine Auswertung, die inzwischen ersetzt wurde, kann nicht bestätigt werden.

Nach Freigabe wird das Ereignis zuerst dauerhaft lokal vorgemerkt und dann über HTTPS übertragen. Erst „accepted“ in der Warteschlange bedeutet vom Hauptprogramm dauerhaft angenommen. Erkannte, bestätigte, korrigierte, verworfene und übertragene Zustände werden unterschieden und protokolliert. Uploads und Bilder älter als 60 Sekunden werden nicht automatisch übernommen. Der Server weist Ereignisse zurück, deren Aufnahme länger als 24 Stunden zurückliegt.

Automatik erfordert eine ausdrückliche Adminfreigabe und mindestens drei übereinstimmende neue Live-Einzelbilder mit hoher Erkennungssicherheit. Bei unklarem oder länger unverändertem Bild wird sie gesperrt. Erst nach einem Praxistest aktivieren.

7. Offline, Neustart und Konflikte

Bei Internetausfall bleibt die lokale Ansicht bedienbar. Freigegebene Ereignisse liegen in der privaten lokalen Datei ~/.sbv-camera/station.sqlite3. Datei und Rechner schützen; diese Datei enthält Tafelausschnitte und Protokolle, keine Gerätepasswörter. Der Dienst versucht die Übertragung mit wachsendem Abstand bis zu zehnmal; anschließend kann derselbe Eintrag ausdrücklich erneut gesendet werden. Ein Browserneustart oder Dienstneustart löscht die Warteschlange nicht. Stations-PIN beim Dienstneustart neu festlegen.

Bei einem Versionskonflikt keine automatische Überschreibung: neueren Stand im Hauptprogramm prüfen. Weitere wartende Ereignisse dieser Partie werden ebenfalls zur Klärung gesperrt. Keine Einträge auf neue Partien umetikettieren oder eigenmächtig mit neuer Version versehen. Nach tatsächlicher Klärung im Hauptprogramm die betroffenen Einträge mit Namen und Begründung ausdrücklich „Als geklärt zurückstellen“. Danach aktuelle Zuordnung prüfen und eine neue Aufnahme freigeben. Die alten Ereignisse werden nicht verändert oder erneut gesendet und bleiben als Nachweis erhalten.

8. Fernsteuerung und technische Abnahme

Jury mit Bearbeitungsrecht kann autorisierte, aktuell verbundene Stationen pausieren, fortsetzen oder neu prüfen. Bewegungen erscheinen nur bei PTZ-fähigen Quellen; derzeit ist dies der PTZ-Simulator. Lokale Bedienung widerruft ausstehende Fernbefehle. Manuelle Bewegung pausiert die automatische Prüfung; danach ausdrücklich fortsetzen. Nicht abgeholte Fernbefehle verfallen nach acht Sekunden und werden nach Wiederverbindung nicht nachgeholt.

Automatisierte Tests prüfen Simulator, Browseroberfläche, Warteschlange, Neustart, Versionsprüfung, Geräteberechtigungen und Empfangsbestätigungen. Reale Kamera, Hallenbeleuchtung, Perspektive, Magnetfarben, örtliche Netzqualität und eine physische Windows-Installation müssen vor dem Produktiveinsatz gesondert abgenommen werden. Der Simulator ist kein Nachweis für zuverlässige Erkennung jeder realen Tafel.