Skip to content

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.