Files
Dreierpack-Manager/docs/new_ui/desktop/live/README.md
T

10 KiB
Raw Blame History

Nativer Live-Ticker als UI-Demo (by Codex)

Der Anstoß-Einstieg der nativen Modern-Demo öffnet ausschließlich den Textticker. Eine grafische Spielansicht gehört nicht zu diesem Paket. Die Fläche bleibt im vorhandenen 3840×2160-Canvas proportional 16:9; die drei Skins verwenden dieselbe Geometrie. Links stehen eine bis vier eindeutige menschliche Partien und ein geteilter Ticker. Rechts wechseln unabhängige Managerpfeile zwischen Team, Taktik, Gegner, Live-Tabelle und Statistik. Es gibt keine Schiedsrichterbox, Manager-Tableiste oben oder leere Eingriffsbox.

Diese Ansicht spielt eine endliche, vorgegebene UI-Demoaufzeichnung ab. Ihre Ergebnisse, Spielereignisse, Statistik und Tabellenstände sind deklarierte Fixtures. Die sichtbare Kennzeichnung bleibt beim Abspielen und im Bericht vorhanden. Weltidentitäten, Namen und vorhandene Spielerattribute stammen aus dem schreibgeschützten Katalog; unbekannte Attribute bleiben unbekannt. Die Ansicht konstruiert weder GameState noch Runtime, liest keinen Spiel-RNG und führt aus einem Timer keine Spielaktion aus. Es entsteht keine zweite Match-Engine.

Provider und Identität

DataSource::read_live(const Json&) const liefert standardmäßig {ok:false,error:"live_unavailable"}. Eine spätere autoritative Sessionanbindung muss diesen Read ausdrücklich implementieren. Der aktuelle DemoSource überschreibt ihn allein mit dem reinen Provider query_demo_live.

{"kind":"fixture","revision":7}

Das Ergebnis enthält ok, schema:"openbmh-live-fixture@1", source:"ui-demo-fixture", fixture_id, source_revision, world, date, role, surface, duration, field_count, owners, matches und frames. Die Source-Revision bezeichnet den gelesenen Ausgangszustand; sie ist weder Ereignissequenz noch Managerauswahl. Die Fixture-ID ist unabhängig von der rechts gewählten Person. Match-IDs enthalten Welt, Datum, Bereich, Fläche und beide Teamidentitäten; Owner-IDs verwenden die stabile Porträtidentität. Zwei menschliche Gegner erscheinen in derselben Partie mit zwei Owner-Referenzen. Jede Partie und jedes Ereignis hat eine eigene ID.

{"kind":"frame","sequence":3,"fixture_id":"ui-live:…","revision":7}

Dieser Read liefert genau einen vorgegebenen Snapshot mit sequence, minute, phase, Matchwerten und dem bis dahin sichtbaren Ereignisprefix. Wiederholte Reads sind identisch und verändern weder Sourcezustand/-revision noch Dirty-Baseline, Weltdateien oder Kalender. Fremde Queryfelder, ungültige Sequenzen und veraltete Revisionen/Fixture-IDs werden ausdrücklich abgewiesen. Ein fehlender Provider wird nicht durch geratene Ergebnisse ersetzt.

Die Aufzeichnung enthält Anpfiff, Heimführung, Verwarnung, Halbzeit, Wiederanpfiff, Ausgleich, Torchance, erneute Heimführung und Abpfiff. Sie endet nach exakt 90 Minuten auf Rasen und 40 Minuten in der Halle. Diese Werte beschreiben die Fixture; sie sind keine hinzugefügten Regeln einer Matchsimulation. Ein kurzer Ergebnis-/Berichtsbildschirm zeigt danach den festgelegten Verlauf, ohne Datum, Wertung, Konten, Nachrichten oder Saisonfortschritt zu publizieren.

Kader- und Bereichsprojektion

Aktive Personen, Team und Fläche kommen aus demo_career_context. Nur die aktive Nationalrolle stellt Deutschland und den zugehörigen menschlichen Owner dar; Vereinsfinanzen und eine Vereins-Ligatabelle werden dort nicht eingeblendet. Die bisherige native Nationaldemo benutzt ausdrücklich die Vereinsaufstellung als Demokaderbasis, nicht als behauptete Nationalkaderberufung. Caps und internationale Tore werden nur bei entsprechenden Katalogattributen angezeigt; andernfalls steht —, nie eine aus Vereinsstatistiken geratene Zahl.

Für jeden Verein liest der Provider dessen aktuelle Präsentationsaufstellung und Taktik: beim aktiven Owner direkt, bei inaktiven aus career_views[club]. Unbesuchte Vereine bekommen ausschließlich reine Aufstellungs-/Taktikdefaults, ohne Source.apply. So übernimmt die rechte Ansicht nicht versehentlich den Kader oder die Änderungen des ersten Managers.

Hallenfelder bleiben getrennt: on_field_limit=6, rotation_rows=min(11, roster_size), roster_size ist die tatsächliche Spielerzahl und roster_limit=null, weil hier keine allgemeine harte Kadergrenze belegt wird. Die Ansicht gruppiert sechs Aktive, bis zu fünf Partner des ersten 11er-Plans und weitere vorhandene Reserven. Die komplette echte Kaderliste bleibt lesbar; interne elf Strukturpunkte machen keine zusätzlichen Feldspieler. Rasen hat elf aktive Positionen und ebenfalls alle vorhandenen Reserven. Der Provider leitet daraus keine neue Auswechsel- oder Kaderregel ab.

Die Live-Tabelle nutzt echte Teamidentitäten, aber ausschließlich vorgegebene Demozahlen, sichtbar als solche gekennzeichnet. Alle Owner derselben Katalogkonkurrenz lesen dabei denselben Tabellensnapshot; nur die eigene Zeilenmarkierung wechselt. Sie rekonstruiert keine Ligahistorie. Kleine Kataloge liefern weniger Zeilen, höchstens 18 werden in der Demo-Tabelle dargestellt. Das Nationaldemo-Länderspiel besitzt keine Ligatabelle.

Reine Wiedergabe und Eingabe

LivePlayback hält eine lokale Kopie der validierten Aufzeichnung. next() zeigt deren nächsten Snapshot; elapse(milliseconds) darf bei Speed 1–4 nur vorhandene Snapshots enthüllen. Speed 0 ist Pause. Ein verzögertes Fenster überspringt keinen unbeschränkten Rückstau. Reads, Managerwahl und Tabwechsel führen keine Ereignisse aus und schreiben keine Savefelder.

Der dezente senkrechte Regler hat seine Pausenstellung unten. Weil RmlUI-Werte nach unten wachsen, speichert allein das native Widget den invertierten Positionswert 4-speed; API, Snapshot, Beschriftung und ARIA-Wert verwenden die logische Geschwindigkeit 0–4. Home setzt Pause, End die höchste Stufe, Pfeil-hoch/-runter ändern die Stufe. P und der Abspielen-/Pausebutton bedienen dieselbe Wiedergabe. Der Regler wird während eines Pointerdrags nicht durch einen Timerrender ersetzt.

Die rechte Ownerauswahl verändert weder Sequenz noch den links gewählten Match- oder Tickerfilter und erhält die Scrollposition des gemeinsamen Tickers. Für ein Einzelspiel gibt es eigene linke Partiepfeile. Beide Auswahlachsen sind getrennt. Tab/Escape und Kontextrechtsklick bleiben auf Liveansicht oder offenem Dialog begrenzt; eine offene gemeinsame Optionsliste behält ihre eigene erste Priorität.

Wechsel- und Taktikvorschau

Aufstellung/Wechsel und Taktik verwenden die vorhandenen reinen Edithelper an einem lokalen Ownerentwurf. Die Dialoge benennen ihre Demogrenze. Eine Übernahme zeigt nur diese Vorschau; sie sendet kein erfolgreiches Enginekommando, ändert keine Source-Revision und beeinflusst die feste Ereignisfolge nicht. Abbrechen verwirft den Entwurf. Die Halle bietet auch weitere vorhandene Reserven an und erfindet keine zusätzliche Austauschgrenze.

Beim Öffnen eines Dialogs pausiert die Wiedergabe; nach Schließen kann nur die vorherige Wiedergabestufe weiterlaufen. Wechselnde Sourceidentität, Welt oder Revision pausieren einen alten Mitschnitt. Ein erneuter Anstoß liest dann eine neue Aufzeichnung. Weltwechsel löschen die lokale Wiedergabe und Entwürfe. Ein normaler Desktop-Rückweg pausiert und kann denselben unveränderten Mitschnitt später wieder öffnen. Kein Playbackzustand wird in einem Karrierecheckpoint oder Original-OBW gespeichert.

Dateien und Prüfung

  • demo_live.hpp/.cpp: reiner Provider, Validierung und finite Playbackklasse.
  • live_state.inc, live_screens.inc, live_controls.inc: lokale Appansicht und Maus-/Tastatureingaben; assets/modern/live.rcss: Layout und drei Skins.
  • modern_live_ui_tests: synthetischer Katalog mit mehreren Menschen, Quellen- invarianten, identischen Reads, Matchdedupe, Ownerwechsel ohne Seek, reiner Pause, 40/90-Abschluss, Scopeguards und lokalen Kaderreferenzen.

Mit modern_live_ui_tests --write-fixtures <neuerOrdner> können reproduzierbare, synthetische Weltdaten und gültige native Democheckpoints für GUI-Tests erzeugt werden. Sie enthalten keine Originaldaten. Die abschließende Linux-/SDL-/RmlUI-Kohorte besteht zehn normal beendete Prozesse mit 1.811 von 1.811 Prüfungen: alle drei Skins bei 1080 und 720, geteilte menschliche Partie, tatsächlicher National-/Hallenwechsel über den Managerhub und ein 3840×2160-Lauf. Geprüft sind echte Maus-/Tastatur-/Mausrad- Eingaben, gesetzte Themepräferenz, Textflächen, Zweispaltigkeit, native Optionsauswahl der letzten echten Reserve, Vorschauabbruch/-übernahme, Home/End/P, unveränderte Source-/Revisions-/Dirty-Werte und Bericht/Rückweg.

Ein separater echter SDL/X11-Lauf mit physischem Down→Move→Halten→mehrere Moves→Up besteht 18/18 Prüfungen. In derselben gehaltenen Geste werden Stufen 4, 2 und 0 erreicht; auch über einen fälligen Replayframe hinaus bleibt die Sequenz bis Pointer-up unverändert. Erst nach Ende der Geste darf das lokale Markup ersetzt werden; der Regler erhält dann seinen Tastaturfokus zurück. Es gibt keinen globalen Mouse-Capture-Workaround.

Die fünf betroffenen CTest-Gruppen modern_live_ui_tests, modern_career_ui_tests, modern_lineup_ui_tests, modern_opening_ui_tests und modern_ui_core_tests sind grün. Die finalen nativen Theme-/Scope-PNGs wurden tatsächlich gesichtet. Private GUI-Ressourcen und Bildschirmbelege bleiben außerhalb dieses öffentlichen Repositories. Windows und macOS sind nicht interaktiv geprüft; dies ist kein Engine- oder Plattformrelease.

Der wiederholbare native Eingabelauf liegt in tools/modern_ui/live_demo_qa.py. Beispiel mit selbst erzeugten Fixtures:

modern_live_ui_tests --write-fixtures /tmp/live-fixtures
python3 tools/modern_ui/live_demo_qa.py \
  --binary /path/to/build/OpenBMH --fixtures /tmp/live-fixtures \
  --gui-assets /path/to/own/gui --output /tmp/live-evidence

Der Treiber erfindet keine Livezustände: Klick, Taste, Mausrad und Wartezeit laufen durch die normalen RmlUI-/SDL-Pfade. Die JSON-/DOM-/Geometrieproben und PNG-Ausgaben bleiben am angegebenen Ziel. Für den eigenen Xvfb werden ein installiertes Xvfb oder alternativ --display benötigt.