Documentation Technique

┌─────────────────────────────────────────────────────┐
│  Extension Chrome (Manifest V3)                     │
│                                                     │
│  ┌──────────────┐     ┌───────────────────────────┐ │
│  │   Interface Popup   │     │     Content Script         │ │
│  │  (React)     │     │   (meet.google.com)        │ │
│  │              │     │                            │ │
│  │  - Bascule    │     │  ┌────────────────────┐   │ │
│  │  - Niveau     │◄───►│  │  Analyseur Audio    │   │ │
│  │  - Réglages  │     │  │  (Web Audio API)   │   │ │
│  │              │     │  └────────┬───────────┘   │ │
│  └──────────────┘     │           │               │ │
│         ▲             │  ┌────────▼───────────┐   │ │
│         │             │  │  Machine à états     │   │ │
│         │             │  │  IDLE → MUTED →    │   │ │
│         │             │  │  SPEAKING → GRACE  │   │ │
│         │             │  └────────┬───────────┘   │ │
│         │             │           │               │ │
│         │             │  ┌────────▼───────────┐   │ │
│         │             │  │  Contrôleur Mute   │   │ │
│         │             │  │  (manipulation DOM)│   │ │
│         │             │  └────────────────────┘   │ │
│         │             └───────────────────────────┘ │
│         │                                           │
│         └─── Chrome Storage API (sync config/état)─┘
│                                                     │
└─────────────────────────────────────────────────────┘

src/
├── constants.ts          # Constantes, modes, seuils, clés de stockage
├── messages.ts           # Messages i18n (EN/JA)
├── i18n.ts               # Gestion des locales
├── manifest.ts           # Définition du manifeste de l'extension Chrome
├── background/
│   └── service-worker.ts # Service Worker (lanceur de jeux, etc.)
├── content/
│   └── index.ts          # Content Script (machine à états, contrôle des modes, raccourcis)
└── popup/
    ├── index.html        # HTML d'entrée du popup
    ├── main.tsx          # Point de montage React
    ├── Popup.tsx         # Composant UI du popup
    ├── popup.css         # Styles
    ├── Equalizer.tsx     # Analyseur de spectre
    ├── ThemeSwitcher.tsx # Sélecteur de thème
    ├── LocaleSwitcher.tsx# Sélecteur de langue
    └── GameLauncher.tsx  # Lanceur de mini-jeux

Utilise l'API Web Audio AnalyserNode pour mesurer le volume d'entrée du microphone en temps réel.

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

Paramètres de configuration :

Une machine à états finis à 5 états gère l'état de la parole.

IDLE ──(mode autre que Off sélectionné)──► MUTED ──(volume > speechThreshold)──► UNMUTING ──► SPEAKING
                     ▲                                                │
                     │                              (volume < silenceThreshold)
                     │                                                │
                     └──(graceTimer expiré)── GRACE ◄─────────────────┘
                                                │
                                         (volume > silenceThreshold)
                                                │
                                                ▼
                                            SPEAKING

* Si l'utilisateur bascule manuellement le microphone Meet, le mode reste le même et seul l'état suit.

Quatre modes contrôlent le comportement des transitions d'état. Off est le mode de contrôle désactivé.

Fournit un raccourci de sourdine personnalisable (par défaut : Ctrl+Shift+M) plus des raccourcis fixes de mode dans l'onglet Meet : Ctrl+Shift+0 Désactivé, Ctrl+Shift+1 Auto, Ctrl+Shift+2 Auto-Off, Ctrl+Shift+3 Appuyer pour parler.

• Off : Désactivé
• Auto : Basculer le micro
• Auto-Off : Basculer le micro
• Push-to-Talk : Réactiver uniquement tant que la touche est enfoncée (maintenir)

Le raccourci de sourdine peut être modifié depuis les réglages du popup. Les raccourcis de changement de mode sont fixes.

Des seuils différents pour la réactivation et la coupure empêchent le chattering (basculement fréquent).

speechThreshold (début de parole)    = 0.025  (par défaut)
silenceThreshold (détection silence) = speechThreshold × 0.5 = 0.0125

  Volume
   ▲
   │  ┄┄┄┄┄┄┄┄┄ speechThreshold (0.025) ┄┄┄┄  ← Réactivation si dépassé
   │
   │  ┄┄┄┄┄┄┄┄┄ silenceThreshold (0.0125) ┄┄  ← Période de grâce si en dessous
   │
   └──────────────────────────────────────────► Temps

Détecte le bouton mute de Google Meet à l'aide de plusieurs stratégies :

1. Recherche par attribut aria-label (prend en charge le japonais et l'anglais)
2. Recherche par attribut data-tooltip
3. Solution de repli : simulation du raccourci clavier Ctrl+D

L'état mute est déterminé à partir de l'attribut data-is-muted ou du contenu textuel de l'aria-label.

Une interface de réglages construite avec React 19. Synchronise l'état avec le Content Script en temps réel via l'API Chrome Storage.

• Sélecteur de mode: Basculer entre Off / Auto / Auto-Off / Push-to-Talk
• Affichage de l'état: Affiche l'état actuel (coupé/en train de parler/grâce) avec un indicateur à pastille
• Indicateur de niveau: Affiche le niveau d'entrée du microphone en temps réel (avec marqueurs de seuil)
• Curseur de sensibilité: Régler le speechThreshold (0.005–0.25) — sauvegardé par mode
• Curseur de période de grâce: Régler le gracePeriod (500ms–4000ms) — sauvegardé par mode
• Réglages du raccourci clavier: Personnalisation via l'interface d'enregistrement de touches
• Sélection du microphone: Sélection manuelle du microphone à utiliser

Popup → Chrome Storage → Content Script
  │                            │
  │  hushMeetConfig: object    │  (réglages sensibilité/période de grâce)
  │  hushMeetMode: string      │  (mode de fonctionnement)
  │  hushMeetShortcutKey: str  │  (touche de raccourci)
  │                            │
  │                            ▼
  │                      Content Script → Chrome Storage → Popup
  │                            │
  │                            │  hushMeetState: string  (état actuel)
  │                            │  hushMeetLevel: number  (niveau de volume)
  │                            │  hushMeetSpectrum: array (spectre)
  └────────────────────────────┘

Le Popup et le Content Script ne communiquent pas directement ; ils communiquent de manière bidirectionnelle via les événements de changement de l'API Chrome Storage.

Commandes

• La détection vocale est basée sur le RMS (volume), elle peut donc se déclencher par erreur en cas de bruit ambiant fort (atténué par l'utilisation du mode Auto-Off)
• Les modifications de l'interface Google Meet peuvent casser la détection du bouton mute
• Le tout début de la parole peut être coupé (ajustable via les réglages de seuil)
• La touche de raccourci ne fonctionne que lorsque l'onglet Google Meet est au premier plan

• Porte de bruit pondérée par la voix pour une meilleure précision de détection
• Mise en mémoire tampon pré-parole pour réduire la coupure en début d'énoncé
• Logique de détection automatique pour suivre les changements d'interface de Google Meet
• Remplacement par Silero VAD (basé sur le ML) pour une précision de détection accrue