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

## Qué sale del dispositivo

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.

## Navegadores y frecuencia de frames

- 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](/docs/es/sdk/on-device/#probar-en-tu-móvil)), 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](/docs/es/start/devices-and-modes/).

## Qué comprueba Engine en cada lote

| 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](/docs/es/concepts/limits/)) |
| El `step` existe en el plan de la posición | `400` con `qualityCode: "KPN-EMO-STEP"` |

```json
{ "status": 400, "qualityCode": "KPN-EMO-STEP" }
```

## Dale unos segundos

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.

## Lotes

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](/docs/es/api/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.

## Recomendaciones del whitepaper

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](/docs/es/concepts/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ñales de calidad

| 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 |
