Skip to content

clap_listener

diapason.speech.clap_listener

Double-clap detector and optional microphone listener (welcome trigger).

ClapDetector dataclass

Stateful detector: feed RMS samples, receive double-clap events.

ClapListener

Background mic loop that invokes a callback on double clap.

claps_entendus property

Combien de pics le micro a relevés — doubles ou non.

dernier_echec property

Pourquoi le dernier pic n'a pas formé un double, s'il y a lieu.

ecoute property

Le micro est-il RÉELLEMENT ouvert ? Constaté, jamais supposé.

fond_sonore property

Le fond sonore que ce fil a APPRIS de la pièce où il tourne.

Comparé au seuil, il dit d'un coup d'œil si la marge est confortable ou si la pièce est montée jusqu'à frôler le déclenchement.

panne property

Pourquoi l'écoute n'a pas démarré, s'il y a une raison.

seuil property

Le seuil que ce fil applique VRAIMENT, à cet instant.

Le lire dans le fichier de réglage reviendrait à proclamer : un fil démarré avant une calibration garde l'ancien seuil jusqu'à ce qu'on le relance, et l'interface afficherait un chiffre auquel personne n'obéit. Zéro quand rien n'écoute — il n'y a alors pas de seuil.

Ecoute dataclass

Une mesure complète : la pièce, puis ce qui s'y est ajouté.

ecartes instance-attribute

Les bouffées écartées : trop faibles pour être les mêmes claps.

Piece dataclass

Ce qu'une pièce fait quand personne ne lui demande rien.

blocs_bruyants instance-attribute

Combien de blocs ont dépassé six fois son niveau habituel.

dispersion instance-attribute

Sa respiration, en log : de combien elle s'écarte d'ordinaire.

haute property

Sa portée haute ordinaire — le plafond de ce qu'elle fait seule.

Trois dispersions, pas cinq : calibré sur la pièce réelle de Carlito, dont le maximum observé vaut deux dispersions au-dessus de la médiane. Cinq donnaient 0,040 pour une pièce qui n'a jamais dépassé 0,0124 — une marge inventée devient un seuil que les claps doivent franchir pour rien.

maximum instance-attribute

Le plus fort entendu, transitoire compris.

niveau instance-attribute

Son niveau habituel — médiane, insensible aux évènements isolés.

troublee property

Quelque chose est arrivé pendant que la pièce devait se taire.

Un COMPTAGE, pas un rapport. Un rapport entre le maximum et une statistique de la même fenêtre monte des deux côtés à la fois : dès que le transitoire dure quatre blocs, il définit lui-même la référence à laquelle on le compare, et la garde se tait précisément quand elle devrait parler. Un clap, attaque et réverbération, dure toujours plus que ça (démontré le 25 août 2026).

charger_reglage_claps()

Le réglage de CETTE pièce — celui d'usine si rien n'est calibré.

Le min_rms calibré est conservé. Les écarts et la similarité, eux, sont ceux d'usine à chaque lecture : un claps.json du 25 août 2026 gardait max_double_gap_s=0.80 et min_double_gap_s=0.04, et deux bruits fortuits — ou l'attaque et la queue d'UN seul choc — ouvraient la caméra (29 août 2026).

choose_input_device(cfg, blocksize, *, override=None, silent_rms=0.0005, probe_s=0.5)

Pick a working mic: override → default if loud → loudest input → default.

ecouter_la_piece(*, cfg=None, device=None, duree_s=2.5, oubli_initial_s=0.6)

Écouter une pièce se taire. Rien n'est enregistré : seuls des niveaux sonores sortent d'ici, jamais de son (§10).

Les premières fractions de seconde sont JETÉES : la mesure est déclenchée par un clic sur la machine qui tient le micro, et ce clic est un transitoire net.

ecouter_les_claps(piece, *, cfg=None, device=None, duree_s=6.0, oubli_initial_s=0.25)

Écouter quelqu'un claper, dans une pièce déjà mesurée.

niveau_ordinaire(blocs)

Le niveau habituel d'un fond sonore, et sa dispersion.

La médiane, pas un quantile haut ni un maximum : un transitoire ne doit pas pouvoir déplacer la statistique qui sert à le juger. Un maximum brut cède devant un seul bloc ; le quantile 0,95 cède devant quatre. La médiane demande d'en corrompre la moitié.

Le calcul se fait sur les logarithmes, parce qu'un niveau sonore se compare en RAPPORTS et non en écarts : entre 0,005 et 0,015 il y a le même chemin qu'entre 0,05 et 0,15.

reglage_calibre(ecoute, *, base=None)

Un seuil posé entre DEUX mesures : la pièce, et les claps de son occupant.

Le seuil vise la moyenne géométrique — le milieu au sens de l'oreille, qui entend des rapports et non des différences.

seuil_de_bouffee(piece)

À partir de quel niveau un son mérite d'être regardé.

Dix fois le fond, au minimum : un clap vaut vingt à soixante fois le niveau habituel d'une pièce. Deux fois et demie laissait entrer une touche de clavier, qui devenait ensuite « le clap le plus faible » et tirait tout le réglage vers le bas.