Ir al contenido
DevLab

Cómo capturar para la máxima precisión

Las condiciones que de verdad comprueban Engine y Capture, lo que les falta a los primeros segundos de una captura y las recomendaciones del whitepaper.

En esta página
  1. Qué sale del dispositivo
  2. Navegadores y frecuencia de frames
  3. Qué comprueba Engine en cada lote
  4. Dale unos segundos
  5. Lotes
  6. Recomendaciones del whitepaper
  7. Señales de calidad

Capture se ejecuta en el navegador y extrae la geometría facial de cada frame: 478 landmarks, 52 coeficientes de expresión y la pose de la cabeza. Del dispositivo solo salen esos números: ni imagen, ni vídeo, ni audio crudo. Con transcripción, sale también el texto. Las señales extra (valores de color del pulso, rasgos de la voz, manos y cuerpo) están apagadas por defecto y solo viajan si las pides.

  • Chrome o Edge 94+, Safari 16.4+ (iOS 16.4+). Firefox no es objetivo: kodec no se ha probado allí.
  • Sirve la página por HTTPS o desde localhost.
  • La frecuencia de frames depende del dispositivo, no de la plataforma: un portátil o un móvil reciente suele quedarse cerca de la de la cámara, un móvil de gama de entrada captura menos frames por segundo y un móvil la pierde según se calienta en una sesión larga. Léelo en ejecución con onCodecEvent('capture-quality') (cómo), no del modelo de teléfono: lo que lo limita es la detección de la cara en la GPU (WebGL 2) y, en móvil, el calor en sesiones largas. El dispositivo, el modo y cómo comprobarlos: Dispositivos, calidad y modo.
Condición Si falla
Cada frame lleva featuresMeta Se acepta y se cuenta en framesWithoutFeaturesMeta; esos frames no dan los ejes de valencia ni de arousal
478 landmarks por frame Se esperan 478 (468 de la cara + 10 del iris). Con 468, medido el 9-ago-2026, Engine aceptó todos los lotes y la sesión no se cerró nunca; un frame sin cara (landmarks: []) no está medido
52 coeficientes de expresión por frame Se acepta; el frame se usa sin ellos
Lotes numerados desde 1 y el último Final Sin el Final, el step queda abierto; si faltan lotes cuando llega el Final: 400 con qualityCode: "KPN-EMO-MISSING-PACKETS" y missingOrders, y ese Final no guarda nada: envía los que faltan y repite el Final (ver Límites declarados)
El step existe en el plan de la posición 400 con qualityCode: "KPN-EMO-STEP"
JSON
{ "status": 400, "qualityCode": "KPN-EMO-STEP" }

Algunos indicadores se calculan sobre una ventana de frames recientes, así que los primeros segundos de una captura no tienen valor para ellos. En una captura de la muestra, workload aparece a partir de unos 5 segundos y luego llega por ventanas, no en todos los frames (qué frame es el primero cambia de una ejecución a otra):

JSON
{ "framesWithWorkload": 21, "framesTotal": 300 }

Planifica capturas más largas que eso: Measurement pide al menos 6 s. Engine no aplica las duraciones de los steps; las aplica tu interfaz.

Envía los lotes en orden, de unos segundos de frames cada uno. Con la cámara, un frame ocupa unos 19,7 KB de JSON desde el SDK 0.35.0 (478 landmarks), así que unos segundos ya pesan varios megabytes. Desde 0.34.0 el SDK corta cada lote en 300 frames o 3 MB de frames, lo que llegue antes (unos 150 frames de cámara); un SDK anterior a 0.34.0 cortaba solo por número, hasta unos 9,3 MB. Si tu proxy limita el tamaño del cuerpo, admite al menos 4,5 MB, o 10 MB delante de un SDK anterior (consulta Proxy); si envías los lotes tú, córtalos por tamaño además de por número de frames. Reenviar el mismo lote es seguro: Engine se queda con la primera copia.

Salen del programa de validación de Neurologyca, no de comprobaciones de la API:

  • una sola persona a la vista;
  • distancia y ángulo de cabeza estables: los niveles absolutos no son comparables entre configuraciones;
  • un baseline personal antes de comparar personas o sesiones.

La calidad se degrada antes de fallar: una señal de baja calidad reduce cuánto se puede confiar en una lectura, en lugar de dar un error.

Señal Dónde
framesWithoutFeaturesMeta Cada 202 de un lote
framesWithoutMediaTime Cada 202 de un lote: frames sin mediaTimeMs (dónde iba un reproductor de estímulos, opcional por frame). Es información, no un error
missingOrders El 202 del último lote del baseline, y el 400 con KPN-EMO-MISSING-PACKETS del lote Final de una captura
qualityCode (KPN-EMO-…) 400 cuando un lote rompe el contrato (step, media, plan, o lotes que faltan antes del Final)
processing.error Stream en vivo: algo falló al procesar una captura; stage dice qué y final si Engine reintentará
hci.warning Stream en vivo: un aviso sobre un indicador que tu contexto incluye, una vez por lote; no es una alerta; DevLab no enseña el nivel que lo dispara (threshold), así que no construyas sobre él; que se envíe depende del entorno