.. _api-audio:

Module Audio (``mirza.audio``)
===============================

Le module ``mirza.audio`` gère la capture microphone, la détection d'activité vocale
(VAD) et le traitement acoustique bas niveau.

.. contents:: Sommaire
   :local:
   :depth: 1

----

Pipeline de Capture Audio
--------------------------

.. list-table:: Séquence de traitement audio en capture
   :widths: 10 25 65
   :header-rows: 1

   * - Étape
     - Composant
     - Rôle
   * - **1**
     - ``DeviceManager``
     - Détection automatique du micro par défaut via SoundDevice
   * - **2**
     - ``AudioProcessor``
     - Enregistrement PCM en anneau (ring buffer), calcul RMS, pre-roll de 16 chunks
   * - **3**
     - ``SileroVadDetector``
     - Analyse VAD par fenêtre de 512 samples — décision speech/silence

----

Routage des Périphériques Audio (``DeviceManager``)
-----------------------------------------------------

.. automodule:: mirza.audio.deviceManager
   :members:
   :undoc-members:
   :show-inheritance:

----

Détecteur d'Activité Vocale Neuronal (``SileroVadDetector``)
-------------------------------------------------------------

.. important::

   Le modèle de détection VAD neural est un réseau léger (~1 Mo) chargé une seule fois
   au démarrage. Il opère sur des fenêtres de 512 samples à 16 kHz et atteint
   une précision > 95 % sur la détection de parole française.

.. list-table:: Paramètres VAD configurables
   :widths: 35 15 50
   :header-rows: 1

   * - Paramètre
     - Défaut
     - Description
   * - ``sampleRate``
     - 16000
     - Fréquence d'échantillonnage en Hz
   * - ``speechThreshold``
     - 0.45
     - Probabilité minimale pour considérer un chunk comme parole
   * - ``silenceDurationThreshold``
     - 0.85 s
     - Durée de silence consécutif avant ``commitAudioStream``
   * - ``preRollChunks``
     - 16
     - Chunks conservés avant la détection de parole (pre-roll)

.. automodule:: mirza.audio.vadDetector
   :members:
   :undoc-members:
   :show-inheritance:

----

Traitement Audio et Enregistrement VAD (``AudioProcessor``)
-------------------------------------------------------------

.. automodule:: mirza.audio.audioProcessor
   :members:
   :undoc-members:
   :show-inheritance: