Guider la personne en position

Ce que le widget affiche avant le début de la capture, ce que chaque repère veut dire, et ce que votre code reçoit au même moment.

Une mesure n’aboutit que si le visage se tient correctement dans le cadre, à la bonne distance, le haut du buste visible. Plutôt que de le dire une fois en espérant, Saphere Scan suit le visage avant la capture et montre, en continu, s’il se tient correctement entre deux repères.

Le sens dans lequel bouger est montré, non écrit : il doit se lire de la même façon en dix langues et dans les deux sens de lecture. Et la consigne dit quoi faire, non ce qui ne va pas. Un court message sous le cadre, dans la langue de l’utilisateur, ne donne que l’état : placez votre visage dans la zone claire, puis ne bougez plus. Avec un départ automatique, une seconde ligne, « La mesure démarre », apparaît sous « Ne bougez plus » ; avec un départ manuel, « Ne bougez plus » cède la place à « Vous êtes bien placé » une fois l’immobilité tenue.

Les conditions d’une bonne mesure expliquent pourquoi la position compte.

Ce que la personne voitCe que cela veut direCe qu’il faut faire
Des flèches vers le bas au repère du hautLe visage est au-dessus de la zone exploitableDescendre
Des flèches vers le haut au repère du basLe visage est en dessous de la zone exploitableMonter
Le cadre qui se resserre sur lui-mêmeLe visage est plus grand que l’espace entre les repèresReculer
Aucun repère, et la ligne du bas demande de placer le visageAucun visage n’est vuEntrer dans le cadre
Aucun repère, et un anneau qui se remplit près de « Ne bougez plus »La position est acceptéeNe plus bouger

Deux choses au sujet de cette consigne méritent d’être sues avant de construire autour.

La consigne et la décision d’accepter ou de refuser se lisent sur la même règle. Une consigne ne peut donc jamais s’afficher alors que la position est acceptée, ni manquer alors qu’un visage est vu et sa position refusée.

« Reculer » est vérifié en premier. Un visage plus grand que la zone exploitable n’y entrera par aucun déplacement, si bien que demander à la personne de monter ou de descendre serait un conseil qui ne peut pas aboutir.

Quand la capture démarre

Une position acceptée n’est pas encore un départ. Le visage doit aussi rester immobile — deux secondes par défaut, d’un seul tenant : tout mouvement reprend le décompte à zéro, et sortir de la zone claire l’efface. La capture démarre alors d’elle-même ou, si la personnalisation a choisi un départ manuel, un bouton apparaît et la capture l’attend. Le bouton reste une fois l’immobilité tenue, même si la personne bouge ensuite ; seule la sortie de la zone claire le retire. Le mode et le délai se règlent dans l’atelier, sous Measurement start, ou par components.placement.start (mode vaut "auto" ou "manual", delay est un nombre de secondes strictement positif).

C’est aussi le moment où votre code peut encore dire non, par le hook beforeMeasureStart. Une fois le départ laissé passer, le cadrage est figé et placement:accepted est rapporté.

Ce que votre code reçoit

Votre code reçoit la même information que l’écran, par l’événement placement:guidance. Son guidance vaut "up", "down" ou "back", ou null — quand rien n’est à corriger, et aussi quand aucun visage n’est vu. À côté, stable dit si le visage est resté immobile depuis l’image précédente. L’événement n’est émis que lorsque l’un des deux change, jamais du seul fait qu’une image a été analysée. Voir les événements.