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:
commit
f986c3ad11
22 changed files with 3288 additions and 0 deletions
255
Design-Briefing.md
Normal file
255
Design-Briefing.md
Normal 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.
|
||||
Loading…
Add table
Add a link
Reference in a new issue