Baseline
Una captura de referencia por persona que calibra todos los protocolos. Engine la recomienda, avisa cuando falta y nunca bloquea sin ella.
Un baseline es una captura corta de referencia de una persona. Engine guarda uno por usuario, común a todos los protocolos, y lo usa para calibrar los indicadores de esa persona. Sin él, solo se aplica la calibración poblacional.
Antes de cualquier protocolo
Sección titulada «Antes de cualquier protocolo»Captura el baseline antes de la primera captura de un protocolo, y otra vez cuando caduque. Engine no bloquea una captura sin baseline: en su lugar, cada respuesta de inscripción trae un baselineWarning.
{ "baselineWarning": { "missing": true, "expired": false, "invalid": false, "message": "No baseline found for this user." }}baselineWarning |
Qué significa | Qué hacer |
|---|---|---|
null |
Hay un baseline válido y vigente | Nada |
missing: true |
El usuario no tiene baseline | Capturar uno |
invalid: true |
La última captura no fue suficientemente buena | Capturar uno nuevo |
expired: true |
Es más antiguo que expiryDays |
Capturar uno nuevo |
Con un baseline válido, la misma inscripción responde:
{ "baselineWarning": null }Compruébalo
Sección titulada «Compruébalo»curl -s "$ENGINE/users/$EXT/baseline" -H "Authorization: Bearer $TOKEN"{ "isValid": true, "status": "valid", "expiryDays": 7 }isValid es true solo si el baseline está vigente y es válido. Lee expiryDays de la respuesta: es un ajuste del entorno, no una constante. Un usuario sin baseline responde:
{ "status": 404, "body": { "code": 404, "message": "No baseline found for this user." } }| Respuesta | Estado | Qué hacer |
|---|---|---|
404 |
Sin baseline | Engine mide igual, con calibración de población, y avisa |
200 · isValid: true |
Válido | Días restantes: lastUpdatedAt + expiryDays − ahora |
200 · isValid: false · status: "invalid" |
Calidad insuficiente | Captura uno nuevo |
200 · isValid: false · status: "valid" |
Caducado | Captura uno nuevo |
En la implementación actual de Engine (pendiente de confirmar con Engine), el baseline descuenta la expresión de reposo de la persona en Joy, Sadness, Surprise, Anger, Disgust, Fear y Neutral (y en lo que depende de ellas, como Frustration) y no cambia Valence ni Arousal. Míralo, y captura uno, en el playground.
Captúralo
Sección titulada «Captúralo»POST /users/{externalId}/baseline recibe frames con el mismo formato que POST /process-kpn-emo, sin step, protocolMechanicId ni triggerAnalysis. Divide la captura en lotes numerados desde 1 y marca el último como Final. El baseline se calcula cuando llega el Final y no falta ningún lote; el último 202 te lo dice:
{ "status": "accepted", "framesWithoutFeaturesMeta": 0, "packetsReceived": 10, "packetsExpected": 10, "missingOrders": []}Un baseline nunca se interpreta y no tiene resultados propios. No inscribes a las personas en el protocolo Baseline: la captura crea lo que necesita. La captura de ejemplo del quickstart también sirve como baseline, sin su step.
Con el SDK
Sección titulada «Con el SDK»const info = await client.getBaselineInfo(userId) // null: aún no hay// también lo recaptura si es inválido o ha caducado (isValid: false)if (!info || !info.isValid) await client.captureBaseline({ userId, source: { type: 'webcam' } })Engine lo calcula en segundo plano: vuelve a leerlo hasta que esté (En el dispositivo (tiempo real)).
Límites
Sección titulada «Límites»- Engine aplica el baseline siempre que exista, sea cual sea su
status, tambiéninvalid. Una captura nueva que salga inválida no sustituye a un baseline válido; si no lo hay, pasa a ser el baseline guardado y se aplica. - El baseline tiene que ser de la misma persona que mides; en el playground, eso es la misma persona y el mismo origen (cámara o muestra sintética).
- No hagas dos capturas de baseline de la misma persona a la vez.
- Los resultados de una captura no dicen si se aplicó un baseline personal.