gestes_routes
diapason.server.gestes_routes
¶
Le mode gestes : armer, envoyer des images, désarmer.
Spatial Mesh, gestes — 25 août 2026. La caméra est ouverte par l'APPLICATION, pas par le serveur : macOS ne pose la question qu'à un paquet, et l'interpréteur Python n'en est pas un (voir docs/spatial-mesh/GESTES.md). L'interface capture donc, et poste ici les images ; le serveur voit, décide, et rend un état.
Le §78 gouverne ce module : rien ne guette en permanence. Une session s'arme explicitement, se désarme d'elle-même après un temps mort, et le voyant vert de la caméra dit la vérité pendant tout ce temps. Une caméra qui tournerait « au cas où » ferait de Diapason autre chose qu'un assistant.
Aucune image n'est écrite sur le disque, jamais : elle vit le temps d'un appel à Vision, et seuls des points articulaires lui survivent.
ChoixDAppareil
¶
Bases: BaseModel
La réponse à « vers lequel ? » : le jeton posé, et un appareil.
FichierPourGeste
¶
Bases: BaseModel
Le chemin rendu par le dialogue natif — jamais un contenu encodé.
appliquer(body)
¶
Poser les seuils dérivés des deux mesures, et les garder.
armer(body=None)
¶
Armer le mode gestes. La caméra ne s'ouvre qu'après, côté interface.
calibrer(pose)
¶
Mesurer une pose — « ouverte » puis « fermee ».
La calibration ne devine pas : elle enregistre ce que la main de CETTE personne produit réellement, et place les seuils entre les deux poses.
choisir_lappareil(body)
¶
Trancher entre les candidats, et envoyer pour de bon.
Le deviceId reçu n'est jamais cru sur parole : il doit figurer dans la
liste que le serveur a lui-même mesurée en posant la question. Un client
ne choisit pas une destination, il choisit PARMI celles qu'on lui a
proposées — c'est ce qui empêche cette route de devenir un « envoie
n'importe quoi à n'importe qui » déguisé en réponse.
claps_actifs()
¶
Le micro écoute-t-il vraiment ? Un objet gardé n'est pas une preuve.
desarmer_route()
¶
Désarmer. L'interface éteint la caméra en recevant cette réponse.
ecouter_les_claps()
¶
Ouvrir le micro pour entendre un double-clap, et rien d'autre.
Le détecteur ne transcrit rien et ne garde rien : il suit le niveau sonore et cherche deux pics rapprochés. Aucune parole n'est analysée, aucun son n'est enregistré.
envoyer_ce_qui_est_tenu(objet, cible)
¶
Envoyer la main vers un appareil, sans question préalable.
Le chemin de « envoie ça sur mon téléphone » quand aucune question n'est en suspens. L'appel est une issue terminale : succès, refus ou erreur viennent du destinataire et consomment l'intention ; recommencer sera un nouveau geste visible, jamais une reprise silencieuse.
finir_la_mesure(pose)
¶
Clore une mesure et rendre sa moyenne — ou avouer qu'il n'y a rien.
image(request)
async
¶
Une image de plus. Rend l'état APRÈS cette image.
Le corps est l'image brute (JPEG ou PNG) envoyée par l'interface. Elle n'est jamais écrite : Vision la lit en mémoire, et seuls des points en sortent.
mesurer_la_piece()
¶
Premier temps : écouter la pièce se taire.
mesurer_les_claps()
¶
Second temps : écouter claper, dans la pièce qu'on vient de mesurer.
ne_plus_ecouter()
¶
Refermer le micro. Il ne doit pas rester ouvert par oubli.
oublier_le_fichier_prepare()
¶
Retirer le fichier préparé sans toucher à ce qui est déjà tenu.
oublier_les_claps()
¶
Revenir au réglage d'usine. Le fil garde son seuil tant qu'il tourne : il faut donc le relancer pour que l'oubli prenne effet.
preparer_un_fichier(body)
¶
Préparer le fichier que le prochain poing attrapera.
Cette porte reste derrière l'authentification locale de l'application. Elle ne téléverse rien et ne renvoie jamais le chemin : le navigateur ne reçoit que le nom, le type et la taille qu'il doit afficher.
renoncer_au_depot()
¶
« Laisse tomber. » Sans cette route, la seule sortie serait le silence.
Une question qui ne peut qu'expirer laisse l'utilisateur attendre quarante-cinq secondes pour apprendre qu'il ne se passera rien. Renoncer est une réponse ; elle mérite d'exister.
repondre_au_choix(attente, cible)
¶
Trancher une question en attente, et rendre ce que le récepteur a dit.
Le jeton sert de clé d'idempotence : deux réponses — un clic ET une phrase — n'envoient qu'une fois.
session_active()
¶
Le mode gestes est-il armé ? Constaté, pour l'interface et les tests.