Windows-Werkzeug, das die Sprechtaste in Squad haelt, solange man redet. - Hauptprogramm mit tkinter-Oberflaeche, Pegelanzeige und Diagnose - Auto-Updater gegen https://sva.tyrveil.com/version.json mit SHA-256-Pruefung - Inno-Setup-Installer und Build-Skript werkzeuge/baue_release.py - Projektuebergabe mit den bekannten Fallstricken Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
9.5 KiB
Design-Briefing: Squad Voice Activation 3.0
Zwei Aufgaben, in dieser Reihenfolge:
- Teil A — ein Design System (Farben, Schrift, Abstände, Bausteine)
- Teil B — die beiden Bildschirme des Programms, gebaut aus Teil A
Ausgangslage
Ein Windows-Desktop-Werkzeug für den Taktik-Shooter Squad. Es misst laufend den Mikrofonpegel und hält die Sprechtaste des Spiels automatisch gedrückt, solange der Spieler redet — Voice Activation für ein Spiel, das nur Push-to-Talk kennt.
Kein Overlay, kein Spielinhalt: ein eigenständiges Fenster neben dem Spiel. Es wird zum Einrichten geöffnet und im Betrieb nur kurz angeschaut, um einen Zustand abzulesen.
Nutzer: Squad-Spieler, überwiegend erwachsen, Mil-Sim-affin, technisch interessiert. Vertraut mit Begriffen wie Local, Squad Radio, Command Radio, WASAPI. Sie mögen nüchterne Werkzeuge und misstrauen verspielten Oberflächen.
Anmutung: Militärisch-funktional, nüchtern, dunkel. Nähe zur Bildsprache des Spiels — gedecktes Olivgrün, Sandtöne, dunkles Metall, Beschriftungen wie auf Gerätefronten. Kein Neon, keine Verläufe, keine Spielereien. Eher Feldfunkgerät als Consumer-App.
Oberstes Ziel: Ablesbarkeit. Der Nutzer kommt aus einem Vollbild-Spiel und muss den Zustand in einer halben Sekunde erfassen.
TEIL A — Design System
Gesucht ist ein kleines, konsequentes System für genau diese Art von Werkzeug. Bitte als benannte Gestaltungsmerkmale anlegen, damit sie in Teil B wiederverwendet werden können.
A1 Farben
Als Rollen definieren, nicht nur als Werte. Benötigt werden mindestens:
- Fensterhintergrund (dunkelste Ebene)
- Flächenfarbe für Eingabefelder und Kästen
- gehobene Fläche für aktiven Reiter und Mauskontakt
- Rahmen- und Trennlinienfarbe
- Textfarbe, Nebentextfarbe
- Akzentfarbe (Olivgrün) in normal und hell
- Signalfarben: Bernstein (Hinweis, Schwelle), Grün (aktiv/sendet), Rot (gesperrt), Grau (untätig)
Bisher verwendete Werte als Ausgangspunkt, gern verbessern:
| Rolle | Wert |
|---|---|
| Fensterhintergrund | #151814 |
| Fläche | #1e231b |
| Fläche gehoben | #2a3125 |
| Linie | #3d4634 |
| Text | #c9cec0 |
| Nebentext | #7f8874 |
| Akzent | #6e8b3d |
| Akzent hell | #8cb04d |
| Bernstein | #d9a441 |
| Rot | #b4472f |
| Grün aktiv | #9ed23f |
A2 Schrift
Zwei Familien, klar getrennt in der Aufgabe:
- Beschriftungen und Fließtext — serifenlos, gut lesbar (bisher Segoe UI)
- Messwerte, Diagnose, Zustandsanzeige — dicktengleich (bisher Consolas)
Gesucht ist eine Skala mit etwa fünf Stufen: Fenstertitel, Kastenüberschrift, Beschriftung, Nebentext, Zustandsanzeige. Versalien sparsam einsetzen — bisher nur für Fenstertitel und die Knöpfe der Statusleiste.
A3 Raster und Abstände
Formularzeilen: links Beschriftung, rechts Bedienelement, konsistent ausgerichtet. Bitte eine Abstandsskala festlegen (Innenabstand von Kästen, Zeilenabstand, Abstand zwischen Gruppen) und durchhalten.
A4 Bausteine
Für jeden Baustein die Zustände normal, Mauskontakt, Fokus und deaktiviert mitdenken:
- Knopf, primär — nur einmal pro Fenster (STARTEN)
- Knopf, sekundär — normale Aktionen, deaktivierbar
- Auswahlliste — auch mit sehr langen Einträgen wie
[WASAPI] Analogue 1 + 2 (Focusrite USB Audio); zusätzlich eine schmale Variante für Tastenauswahl - Textfeld — einzeilig
- Zahlenfeld mit Schrittpfeilen
- Schieberegler mit Zahlenanzeige daneben
- Kontrollkästchen mit ein- und zweizeiliger Beschriftung
- Reiter — genau zwei, aktiver deutlich abgesetzt
- Gerahmter Kasten mit Überschrift in der Rahmenlinie
- Diagnosefeld — mehrzeilig, dicktengleich, gerahmt
- Pegelanzeige — siehe A5
- Zustandsanzeige — siehe A6
- Statuszeile — dezente, mitlaufende Textzeile unter einem Element
- Hinweistext — mehrzeilig, gedämpft
A5 Pegelanzeige — Kernstück
Kein gewöhnlicher Fortschrittsbalken. Etwa 40 schmale senkrechte Segmente in einem Rahmen. Gefüllte Segmente zeigen den aktuellen Pegel, leere bleiben dunkel. Eine senkrechte bernsteinfarbene Marke steht an der Position der Auslöseschwelle.
Der Nutzen: Man sieht sofort, ob die eigene Stimme über die Schwelle kommt. Bleiben die gefüllten Segmente links der Marke, löst nichts aus. Genau daran scheitern Nutzer beim Einrichten — deshalb ist das der wichtigste Blickfang des Fensters.
Bitte auch entwerfen, wie die Anzeige im aktiven Zustand (es wird gerade gesendet) anders aussieht als im horchenden.
A6 Zustandsanzeige
Vier sich ausschließende Zustände, jeweils Punkt plus Text:
| Zustand | Text | Farbe | Bedeutung |
|---|---|---|---|
| gestoppt | ● BEREITSCHAFT | grau | läuft nicht |
| bereit | ● HORCHT | bernstein | läuft, wartet auf Stimme |
| aktiv | ● SENDET | grün | Taste wird gerade gehalten |
| blockiert | ● GESPERRT | rot | pausiert, Grund steht daneben |
Muss aus zwei Metern Abstand erkennbar sein. Farbe allein darf nicht das einzige Unterscheidungsmerkmal sein.
TEIL B — Die Bildschirme
Ein Fenster, Standardgröße 700 × 780 px, verkleinerbar bis etwa 660 × 480. Aufbau von oben nach unten: Kopfbereich, zwei Reiter, Statusleiste am unteren Rand (immer sichtbar, auch bei kleinem Fenster).
Kopfbereich
- Titel SQUAD VOICE ACTIVATION
- Untertitel „Hält die Sprechtaste, solange du redest."
- Trennlinie darunter
Bildschirm 1 — Reiter „Mikrofon"
Formularzeilen:
| Beschriftung | Bedienelement | Anmerkung |
|---|---|---|
| Mikrofon | Auswahlliste + Knopf „Neu laden" | lange Einträge, Präfix [WASAPI] / [MME] |
| Schwelle | Schieberegler + Zahlenwert | 0.002 bis 0.100, dreistellig angezeigt |
| Pegel | Pegelanzeige + Zahlenwert | das Kernstück aus A5 |
| Nachlaufzeit | Zahlenfeld + „ms nach dem letzten Wort" | 100 bis 2000 |
Darunter zwei gerahmte Kästen:
„Warum sendet es (nicht)?" — Diagnosefeld, zwei bis vier Zeilen. Beispielinhalt:
Pegel 0.0413 / Schwelle 0.0250 -> über Schwelle
Blockiert: Squad nicht im Vordergrund
-> Squad anklicken, oder den Haken im
Reiter 'Tasten und Verhalten' entfernen.
„Eingabetest" — Knopf „PTT-Taste testen (1 Sekunde halten)" plus Ergebnistext daneben.
Abschließend ein vierzeiliger Hinweistext in gedämpfter Farbe.
Bildschirm 2 — Reiter „Tasten und Verhalten"
-
Zeile Sprechtaste: schmale Auswahlliste (Zusatztaste), ein „+", schmale Auswahlliste (Taste), dahinter grauer Hinweis
-
Gerahmter Kasten „Andere Sprechtasten — Automatik pausiert, solange eine gehalten wird" mit drei gleich aufgebauten Zeilen:
Beschriftung Zusatztaste Taste Hinweis Squad Radio (kein) + B meist B Command Radio (kein) + G meist G Weitere Taste (kein) + (keine) optional -
Dreizeiliger Erklärtext
-
Gerahmter Kasten „Verhalten":
- Kontrollkästchen „Alles nur aktiv, solange dieses Programm im Vordergrund ist:" — darunter eingerückt ein Textfeld mit dem Prozessnamen und eine mitlaufende Statuszeile („gerade im Vordergrund: SquadGame-Win64-Shipping.exe")
- Kontrollkästchen „Pausieren, solange ein Mauszeiger sichtbar ist (Deploy-Screen, Menü, Karte)" — darunter mitlaufende Statuszeile („Mauszeiger gerade ausgeblendet")
- Zeile „Stummschalt-Hotkey (nur im Spiel)" + schmale Auswahlliste
- Kontrollkästchen „Signalton beim Umschalten (hoch = aktiv, tief = stumm)"
-
Zum Abschluss eine dezente Zeile „Alle Änderungen werden sofort gespeichert." mit Zeitstempel der letzten Speicherung
Statusleiste
Über die volle Breite, oben abgetrennt durch eine Linie.
- Links: STARTEN (der einzige primäre Knopf im ganzen Fenster) und STOPPEN (sekundär, im Ruhezustand deaktiviert)
- Rechts: Detailtext (etwa „Funk aktiv (B)" oder „WASAPI @ 48000 Hz") und daneben die Zustandsanzeige aus A6
Bitte zusätzlich zeigen
Die Zustandsanzeige und die Pegelanzeige sind die einzigen Elemente, die im laufenden Betrieb wirklich abgelesen werden. Deshalb wären hilfreich:
- Bildschirm 1 im Zustand SENDET — Pegel über der Schwelle
- Bildschirm 1 im Zustand GESPERRT — Pegel über der Schwelle, aber blockiert, mit Grund im Diagnosefeld
- Die vier Zustände der Zustandsanzeige nebeneinander
Technische Rahmenbedingungen
Die Oberfläche ist mit Python und Tkinter/ttk gebaut. Das begrenzt, was sich unmittelbar umsetzen lässt:
Gut machbar: freie Farben für Flächen, Text und Rahmen; eigene Schriftarten und -größen; Rahmen und Trennlinien; beliebige Grafik auf einer Zeichenfläche (die Pegelanzeige ist bereits so gebaut — dort ist gestalterisch fast alles möglich); Bilder als Symbole.
Nicht oder nur mit erheblichem Aufwand: abgerundete Ecken an Standardelementen, Schlagschatten, Verläufe hinter Bedienelementen, Transparenz, weiche Animationen, Platzhaltertexte in Eingabefeldern.
Ein Entwurf darf gern darüber hinausgehen. Dann bitte kenntlich machen, welche Teile über den Standardumfang hinausgehen — sie müssten dann als selbstgezeichnete Flächen entstehen oder ein anderes Oberflächen-Werkzeug erfordern.
Woran der Entwurf gemessen wird
- Der Zustand ist auf einen Blick erfassbar, auch aus zwei Metern.
- Die Beziehung zwischen Pegel und Schwelle wird sofort verständlich — das ist die häufigste Hürde beim Einrichten.
- Der zweite Reiter mit seinen vielen Auswahlfeldern wirkt geordnet, nicht überladen.
- Es sieht nach Werkzeug aus, nicht nach Spielerei.