Eventos del Player

1. Dos formas de recibirlos

Para una pantalla concreta puedes escuchar CustomEvent sobre el Player. Para una integración centralizada utiliza emitEvent; así no dependes de montar listeners distintos en cada vista.

const player = document.querySelector('p2lrn-player');

player.addEventListener('p2lrn:score', (event) => {
  console.log(event.detail);
  console.log(event.detail.event);
});

En DOM, los campos del payload aparecen directamente en event.detail, junto con event.detail.context y el sobre canónico completo en event.detail.event.

2. Sobre canónico

El objeto que recibe HostAdapter.emitEvent(event, context) mantiene siempre la misma envoltura, independientemente del renderer que lo origine.

{
  "schema": "https://p2lrn.org/schema/runtime-event/1",
  "version": "1",
  "type": "p2lrn:complete",
  "timestamp": "2026-10-16T08:30:00.000Z",
  "context": {
    "packageId": "urn:uuid:...",
    "contentRoot": "sha256:...",
    "entityId": "urn:uuid:...",
    "resourceId": "urn:uuid:...",
    "representationId": "urn:uuid:...",
    "rendererId": "https://p2lrn.org/renderer/..."
  },
  "payload": {}
}

schema y version identifican el contrato; type identifica el evento; timestamp es la hora del runtime; context localiza el contenido; payload contiene los datos específicos.

3. Eventos de carga y representación

4. Eventos de interacción

5. Estado, puntuación y finalización

6. H5P y xAPI

H5P puede emitir statements xAPI. P2LRN los expone sin convertirlos en identidad de confianza de la plataforma.

Si vas a enviar xAPI a un LRS, reconstruye actor, authority, registration/intento y demás campos de confianza en el servidor de tu plataforma.

7. Errores

p2lrn:error incluye una phase cuando la implementación conoce la fase que falló. Puede aparecer al cargar el paquete, representar contenido, guardar estado, informar nota, enviar eventos, resolver secuenciación o ejecutar un runtime.

El error técnico sirve para diagnóstico. La interfaz de tu aplicación debe decidir el mensaje que se enseña al alumno y qué errores son recuperables.

8. Orden y persistencia con Host Adapter

Las llamadas a emitEvent se serializan por Adapter: un evento se entrega después del anterior. Si tu callback falla, P2LRN produce localmente un p2lrn:error de fase emitEvent sin reenviar recursivamente ese mismo error al Adapter que está fallando.

Para un historial analítico conserva el sobre canónico. Para reanudación utiliza saveState; no intentes reconstruir el estado actual reproduciendo todo el log de eventos salvo que tu plataforma lo haya diseñado expresamente así.

9. Qué eventos guardar

No es obligatorio almacenar todos los eventos. Una plataforma puede guardar sólo notas/estado, o mantener un log completo si necesita analítica detallada.

10. Nombres que debes utilizar

La guía Métricas y analítica explica qué extraer de cuestionarios, SCORM, H5P y progresión y cómo asociarlo a alumno e intento.

Intentos e interacciones enriquecidas

Los cuestionarios nativos emiten ahora eventos explícitos de ciclo de intento e interacción para que una plataforma pueda distinguir inicio, reanudación y entrega sin reconstruirlos a partir del DOM.