Les conditions d'une bonne mesure

Ce que la caméra doit voir pour qu’un pouls soit lisible, comment le widget guide vers la bonne position, et ce qu’un fichier enregistré doit respecter.

Saphere lit un changement de couleur bien trop faible pour l’œil. Les conditions qui le rendent lisible ne sont pas des préférences. En dessous, il n’y a aucun signal à lire, et aucun calcul n’en ramène un.

Cette page énumère les quatre conditions, et dit ce qu’il faut faire quand elles ne sont pas réunies.

Les quatre conditions

La lumière doit tomber sur le visage. Lumière du jour ou lumière de la pièce, raisonnablement égale, venue de face. L’erreur courante est la disposition inverse : une personne assise devant une fenêtre lumineuse apparaît comme une silhouette sombre, et une silhouette sombre ne porte aucun signal. Une lumière dure et directe ou une quasi-obscurité échouent pour la même raison, aux deux autres extrémités de la plage.

La personne doit rester immobile. Le mouvement change la quantité de lumière qui atteint la peau, bien plus qu’un battement de cœur, et le masque. Respirer et s’ajuster légèrement ne posent pas de problème. Se tourner, parler et marcher, si.

Le visage doit être découvert. La mesure lit de la peau. Écharpes, cols montants, chapeaux enfoncés et masques retirent précisément les zones qu’elle lit.

Le visage doit être dans le cadre, à la bonne distance, le haut du buste visible. Environ 40 à 60 cm de la caméra, la caméra à peu près à hauteur de visage, la personne droite et lui faisant face. Le haut du buste compte pour la fréquence respiratoire, qui se lit dans son mouvement.

Concevez pour ces conditions, ne vous contentez pas de les énoncer

Les premiers écrans du widget existent pour expliquer ces quatre points avant que la caméra ne s’ouvre, en dix langues. Si vous remplacez ces écrans par votre propre formulation, conservez ce qu’ils disent. Une fois la caméra ouverte, il guide aussi la personne en position : voir guider la personne en position.

Quand vous envoyez un fichier enregistré

L’API accepte un fichier que vous avez enregistré vous-même. Tout ce qui précède s’applique encore, avec une différence qui compte : personne ne guide la personne. Le cadrage utilisé est celui que vous obtenez, et un fichier qui manque les conditions produit une mesure qui échoue à la fin plutôt qu’une correction au début.

ExigenceValeur
Durée30 secondes recommandées ; en dessous de 10 secondes le fichier est refusé (VIDEO_DURATION_ERROR), et seules les 30 premières secondes environ sont lues
Cadence13 à 35 images par seconde ; en dehors, le fichier est refusé (CONFORMITY_LOW_FPS, CONFORMITY_HIGH_FPS, ou CONFORMITY_UNKNOWN_FPS quand la cadence est absente ou invraisemblable)
TailleJusqu’à 100 Mio
CadrageDroit, face à la caméra, caméra à hauteur de visage, haut du buste visible — dès la première image, qui est celle où le visage est cherché
Distance40 à 60 cm
LumièreÉgale, ni dure ni faible
MouvementAussi peu que possible sur tout l’enregistrement

Les formats de fichier acceptés sont énumérés sur la page des mesures.

Quand une mesure déçoit

Une mesure terminée porte sa propre explication : une variable qui n’a pas pu être calculée revient avec un code d’erreur qui en nomme la raison, plutôt qu’avec une absence muette. C’est le premier endroit où regarder. Les codes qui désignent les conditions ci-dessus sont ceux-ci :

CodeCe qu’il ditCe qu’il faut changer
CONFORMITY_FACE_PRESENCE, CONFORMITY_FACE_SIZELe visage n’a pas été trouvé, ou n’était pas bien dans le cadreCentrer le visage, entièrement visible, à la bonne distance
CONFORMITY_POOR_LIGHT, CONFORMITY_ONDULATIONSLa lumière n’était pas suffisantePlus de lumière, tombant sur le visage
CONFORMITY_MUCH_VARIATIONSTrop de choses ont changé pendant la captureRester immobile, et garder une lumière stable
CONFORMITY_LOW_FPSLa caméra a livré trop peu d’images par secondeCharger l’appareil, couper le mode économie d’énergie, fermer les autres applications
CONFORMITY_MISSING_SIGNALAucun signal exploitable n’est sorti de la captureMesurer de nouveau

Le widget transforme chacun d’eux en une courte explication sur son écran de résultat, dans la langue de la personne.