squad-manager/Design-Briefing.md
danny f986c3ad11 Squad Voice Activation 3.2 - Ausgangsstand
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>
2026-09-10 17:22:54 +02:00

255 lines
9.5 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 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:
1. **Knopf, primär** — nur einmal pro Fenster (STARTEN)
2. **Knopf, sekundär** — normale Aktionen, deaktivierbar
3. **Auswahlliste** — auch mit sehr langen Einträgen wie
`[WASAPI] Analogue 1 + 2 (Focusrite USB Audio)`; zusätzlich eine
schmale Variante für Tastenauswahl
4. **Textfeld** — einzeilig
5. **Zahlenfeld** mit Schrittpfeilen
6. **Schieberegler** mit Zahlenanzeige daneben
7. **Kontrollkästchen** mit ein- und zweizeiliger Beschriftung
8. **Reiter** — genau zwei, aktiver deutlich abgesetzt
9. **Gerahmter Kasten** mit Überschrift in der Rahmenlinie
10. **Diagnosefeld** — mehrzeilig, dicktengleich, gerahmt
11. **Pegelanzeige** — siehe A5
12. **Zustandsanzeige** — siehe A6
13. **Statuszeile** — dezente, mitlaufende Textzeile unter einem Element
14. **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:
1. Bildschirm 1 im Zustand **SENDET** — Pegel über der Schwelle
2. Bildschirm 1 im Zustand **GESPERRT** — Pegel über der Schwelle, aber
blockiert, mit Grund im Diagnosefeld
3. 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
1. Der Zustand ist auf einen Blick erfassbar, auch aus zwei Metern.
2. Die Beziehung zwischen Pegel und Schwelle wird sofort verständlich —
das ist die häufigste Hürde beim Einrichten.
3. Der zweite Reiter mit seinen vielen Auswahlfeldern wirkt geordnet,
nicht überladen.
4. Es sieht nach Werkzeug aus, nicht nach Spielerei.