Ir al contenido
DevLab

Una captura de referencia por persona que calibra todos los protocolos. Engine la recomienda, avisa cuando falta y nunca bloquea sin ella.

En esta página
  1. Qué es
  2. Antes de cualquier protocolo
  3. Compruébalo
  4. Captúralo
  5. Con el SDK
  6. Límites

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.

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.

JSON
{
"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:

JSON
{ "baselineWarning": null }
Shell
curl -s "$ENGINE/users/$EXT/baseline" -H "Authorization: Bearer $TOKEN"
JSON
{ "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:

JSON
{ "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.

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:

JSON
{
"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.

JavaScript
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)).

  • Engine aplica el baseline siempre que exista, sea cual sea su status, también invalid. 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.