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>
This commit is contained in:
danny 2026-09-10 17:22:54 +02:00
commit f986c3ad11
22 changed files with 3288 additions and 0 deletions

255
Design-Briefing.md Normal file
View file

@ -0,0 +1,255 @@
# 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.