Technische Dokumentation

┌─────────────────────────────────────────────────────┐
│  Chrome-Erweiterung (Manifest V3)                     │
│                                                     │
│  ┌──────────────┐     ┌───────────────────────────┐ │
│  │   Popup-UI   │     │     Content Script         │ │
│  │  (React)     │     │   (meet.google.com)        │ │
│  │              │     │                            │ │
│  │  - Umschalten    │     │  ┌────────────────────┐   │ │
│  │  - Messer     │◄───►│  │  Audio-Analysator    │   │ │
│  │  - Einstellg.  │     │  │  (Web Audio API)   │   │ │
│  │              │     │  └────────┬───────────┘   │ │
│  └──────────────┘     │           │               │ │
│         ▲             │  ┌────────▼───────────┐   │ │
│         │             │  │  Zustandsautomat     │   │ │
│         │             │  │  IDLE → MUTED →    │   │ │
│         │             │  │  SPEAKING → GRACE  │   │ │
│         │             │  └────────┬───────────┘   │ │
│         │             │           │               │ │
│         │             │  ┌────────▼───────────┐   │ │
│         │             │  │  Stumm-Controller   │   │ │
│         │             │  │  (DOM-Manipulation)│   │ │
│         │             │  └────────────────────┘   │ │
│         │             └───────────────────────────┘ │
│         │                                           │
│         └─── Chrome Storage API (Konfig/Status-Sync)─┘
│                                                     │
└─────────────────────────────────────────────────────┘

src/
├── constants.ts          # Konstanten, Modi, Schwellenwerte, Storage-Schlüssel
├── messages.ts           # i18n-Nachrichten (EN/JA)
├── i18n.ts               # Sprachverwaltung
├── manifest.ts           # Chrome-Erweiterung Manifest-Definition
├── background/
│   └── service-worker.ts # Service Worker (Spiel-Launcher, etc.)
├── content/
│   └── index.ts          # Content Script (Zustandsautomat, Modussteuerung, Tastenkürzel)
└── popup/
    ├── index.html        # Popup-Einstiegs-HTML
    ├── main.tsx          # React-Einbindung
    ├── Popup.tsx         # Popup-UI-Komponente
    ├── popup.css         # Styles
    ├── Equalizer.tsx     # Spektrumanalysator
    ├── ThemeSwitcher.tsx # Theme-Umschalter
    ├── LocaleSwitcher.tsx# Sprachumschalter
    └── GameLauncher.tsx  # Minispiel-Launcher

Verwendet die Web Audio API AnalyserNode zur Echtzeitmessung der Mikrofon-Eingangslautstärke.

getUserMedia() → AudioContext → MediaStreamSource → AnalyserNode
                                                          │
                                                    getFloatTimeDomainData()
                                                          │
                                                    RMS-Berechnung (Root Mean Square)

Konfigurationsparameter:

Ein endlicher Zustandsautomat mit 5 Zuständen verwaltet den Sprechzustand.

IDLE ──(Modus außer Aus gewählt)──► MUTED ──(Lautstärke > Sprachschwelle)──► UNMUTING ──► SPEAKING
                     ▲                                                │
                     │                              (Lautstärke < Stilleschwelle)
                     │                                                │
                     └──(Nachklingtimer abgelaufen)── GRACE ◄────────────────┘
                                                │
                                         (Lautstärke > Stilleschwelle)
                                                │
                                                ▼
                                            SPEAKING

* Wenn der Benutzer das Meet-Mikrofon manuell umschaltet, bleibt der Modus gleich und nur der Zustand folgt.

Vier Modi steuern das Verhalten der Zustandsübergänge. Aus ist der deaktivierte Modus.

Bietet ein anpassbares Tastenkürzel (Standard: Strg+Umschalt+M).

• Aus: Deaktiviert
• Auto: Stummschaltung umschalten
• Auto-Aus: Stummschaltung umschalten
• Push-to-Talk: Freischalten nur solange die Taste gedrückt wird (Halte-Bedienung)

Das Tastenkürzel kann in den Popup-Einstellungen frei geändert werden.

Unterschiedliche Schwellenwerte für Freischalten und Stummschalten verhindern Flattern (häufiges Umschalten).

Sprachschwelle (Sprachbeginn)    = 0,025  (Standard)
Stilleschwelle (Stilleerkennung) = Sprachschwelle × 0,5 = 0,0125

  Lautstärke
   ▲
   │  ┄┄┄┄┄┄┄┄┄ Sprachschwelle (0,025) ┄┄┄┄  ← Freischalten bei Überschreitung
   │
   │  ┄┄┄┄┄┄┄┄┄ Stilleschwelle (0,0125) ┄┄  ← Nachklingzeit beginnt bei Unterschreitung
   │
   └──────────────────────────────────────────► Zeit

Erkennt die Google Meet-Stummschaltungstaste mit mehreren Strategien:

1. Suche nach aria-label-Attribut (unterstützt Japanisch/Englisch)
2. Suche nach data-tooltip-Attribut
3. Fallback: Simulation des Strg+D-Tastenkürzels

Der Stummschaltungszustand wird aus dem data-is-muted-Attribut oder dem aria-label-Textinhalt ermittelt.

Eine mit React 19 erstellte Einstellungs-UI. Synchronisiert den Zustand mit dem Content Script in Echtzeit über die Chrome Storage API.

• Modus-Auswahl: Umschalten zwischen Aus / Auto / Auto-Aus / Push-to-Talk
• Statusanzeige: Zeigt den aktuellen Zustand (stummgeschaltet/sprechend/Nachklingzeit) mit einer Punkt-Anzeige
• Pegelmesser: Zeigt den Mikrofon-Eingangspegel in Echtzeit an (mit Schwellenwert-Markierungen)
• Empfindlichkeitsregler: Anpassung von speechThreshold (0,005–0,25) — pro Modus gespeichert
• Nachklingzeit-Regler: Anpassung von gracePeriod (500ms–4000ms) — pro Modus gespeichert
• Tastenkürzel-Einstellungen: Anpassung über Tastenaufnahme-UI
• Mikrofongeräte-Auswahl: Manuelle Auswahl des zu verwendenden Mikrofons

Popup → Chrome Storage → Content Script
  │                            │
  │  hushMeetConfig: object    │  (Empfindlichkeit/Nachklingzeit-Einstellungen)
  │  hushMeetMode: string      │  (Betriebsmodus)
  │  hushMeetShortcutKey: str  │  (Tastenkürzel)
  │                            │
  │                            ▼
  │                      Content Script → Chrome Storage → Popup
  │                            │
  │                            │  hushMeetState: string  (aktueller Zustand)
  │                            │  hushMeetLevel: number  (Lautstärkepegel)
  │                            │  hushMeetSpectrum: array (Spektrum)
  └────────────────────────────┘

Popup und Content Script kommunizieren nicht direkt; sie kommunizieren bidirektional über Chrome Storage API-Änderungsereignisse.

Befehle

• Die Spracherkennung basiert auf RMS (Lautstärke) und kann bei lauten Umgebungsgeräuschen fehlauslösen (wird durch Auto-Aus-Modus abgemildert)
• Änderungen an der Google Meet-UI können die Stummschaltungstasten-Erkennung beeinträchtigen
• Der Anfang einer Äußerung kann abgeschnitten werden (einstellbar über Schwellenwert-Einstellungen)
• Das Tastenkürzel funktioniert nur, wenn der Google Meet-Tab fokussiert ist

• Sprachgewichtetes Noise-Gate für verbesserte Erkennungsgenauigkeit
• Vor-Sprach-Pufferung zur Reduzierung des Abschneidens am Äußerungsbeginn
• Auto-Erkennungslogik zur Anpassung an Google Meet-UI-Änderungen
• Silero VAD (ML-basiert) Ersatz für höhere Erkennungsgenauigkeit