SCORM Runtime API

¿Qué es la SCORM Runtime API?

La SCORM Runtime API es la interfaz de programación JavaScript que permite la comunicación en tiempo real entre un curso e-learning y el LMS (Learning Management System) que lo aloja. Es el mecanismo técnico que hace posible que el LMS registre automáticamente el progreso del alumno, su puntuación, el tiempo dedicado y el estado de finalización del curso.

En el contexto del e-learning corporativo, la SCORM Runtime API es el puente invisible que conecta el contenido formativo con la plataforma de gestión. Sin ella, el LMS no podría saber si un empleado ha completado un módulo de onboarding, cuánto tiempo ha dedicado a una formación obligatoria o qué nota ha obtenido en una evaluación.

Cómo funciona la SCORM Runtime API en la práctica

Cuando un alumno lanza un curso SCORM desde su LMS, se ejecuta una secuencia de comunicaciones definida por la SCORM Runtime Environment (RTE). El curso —denominado técnicamente SCO (Sharable Content Object)— localiza un objeto JavaScript llamado API o API_1484_11 expuesto por el LMS en la ventana padre o en el frame contenedor.

Una vez localizado ese objeto, el SCO puede llamar a las funciones de la API para iniciar la sesión, leer datos previos del alumno, guardar su progreso y cerrar la comunicación correctamente al finalizar. Este proceso ocurre de forma transparente para el usuario y garantiza que todos los datos de formación queden registrados en el LMS con independencia del dispositivo o navegador utilizado.

La especificación diferencia dos versiones con nombres de función ligeramente distintos: SCORM 1.2 usa el prefijo LMS (ej. LMSInitialize), mientras que SCORM 2004 usa el prefijo Initialize sin prefijo LMS (ej. Initialize, GetValue).

Las 8 funciones principales de la SCORM Runtime API

Tanto SCORM 1.2 como SCORM 2004 definen exactamente 8 funciones obligatorias que todo LMS compatible con SCORM debe implementar. Estas funciones forman el contrato técnico entre el curso y la plataforma:

El modelo de datos CMI: qué información rastrea la SCORM Runtime API

La SCORM Runtime API no solo define las funciones de comunicación, sino también el modelo de datos CMI (Computer-Managed Instruction) que determina qué variables pueden intercambiarse entre el curso y el LMS. Estos elementos de datos son la información real que se registra en cada sesión formativa.

Los elementos más relevantes para la gestión de formación corporativa son:

• cmi.core.lesson_status — Estado del curso: passed, failed, completed, incomplete, browsed o not attempted.
• cmi.core.score.raw — Puntuación numérica obtenida por el alumno.
• cmi.core.session_time — Tiempo invertido en la sesión actual.
• cmi.core.lesson_location — Marcador de posición (bookmark) para reanudar el curso donde se dejó.
• cmi.core.student_name — Nombre del alumno, proporcionado por el LMS al inicio.
• cmi.suspend_data — Datos libres que el curso puede guardar para uso interno (estado de actividades, respuestas previas, etc.).

En SCORM 2004, el modelo de datos se amplía considerablemente y permite registrar las respuestas a interacciones individuales (cmi.interactions), los objetivos de aprendizaje alcanzados (cmi.objectives) y estados de competencia más granulares.

Qué implica la SCORM Runtime API para los responsables de formación

Para un L&D Manager o responsable de formación, entender la SCORM Runtime API tiene implicaciones prácticas directas, aunque no sea necesario escribir una línea de código:

• Compatibilidad con el LMS: para que el tracking funcione, el LMS debe implementar correctamente el API Adapter. Un LMS compatible con SCORM garantiza que las 8 funciones de la API están disponibles para todos los cursos publicados en ese estándar.
• Calidad de los informes: si la herramienta de autor que usas para crear los cursos no llama correctamente a LMSSetValue o no ejecuta LMSCommit antes de cerrar, el LMS puede no registrar el estado de finalización aunque el alumno haya completado el contenido.
• Reanudación de cursos: la capacidad de retomar un curso desde el último punto visitado depende de que el SCO guarde correctamente cmi.core.lesson_location vía LMSSetValue. Si tu plantilla de curso no implementa este comportamiento, los alumnos siempre empezarán desde el principio.
• Diagnóstico de problemas: cuando un curso no registra completados o no envía puntuaciones, el origen suele estar en un fallo de la Runtime API: LMS que no expone el API Adapter correctamente, o curso que no llama a LMSFinish al cerrarse.

SCORM Runtime API en SCORM 1.2 vs. SCORM 2004

Las dos versiones principales del estándar comparten la misma lógica de la Runtime API, pero difieren en nombres de función y capacidades del modelo de datos. La elección entre ambas depende del nivel de detalle de seguimiento que necesite tu organización y de la compatibilidad de tu LMS.

SCORM 1.2 sigue siendo el estándar más extendido en entornos corporativos a nivel global: su sencillez y la amplia compatibilidad con casi cualquier reproductor SCORM lo mantienen como primera opción en muchas organizaciones. SCORM 2004 añade secuenciación condicional avanzada y un modelo de datos más granular, pero requiere LMS y herramientas de autor con soporte explícito para sus cuatro ediciones.

Para un análisis detallado de las diferencias técnicas y de uso entre ambas versiones, consulta nuestra guía comparativa: SCORM 1.2 vs. SCORM 2004: ¿cuál elegir?

Relación entre la SCORM Runtime API y el paquete SCORM

La SCORM Runtime API es solo uno de los tres componentes técnicos que forman el estándar SCORM completo. Para entender el conjunto, es útil distinguirlos:

• Content Aggregation Model (CAM): define cómo se empaqueta el contenido en un archivo ZIP con el fichero imsmanifest.xml que describe la estructura del curso.
• Runtime Environment (RTE): es el componente que contiene la SCORM Runtime API. Define cómo el LMS lanza el contenido y cómo el SCO se comunica con él durante la ejecución.
• Sequencing and Navigation (S&N): exclusivo de SCORM 2004, define las reglas de navegación condicional entre SCOs.

Cuando se importa un paquete SCORM en un LMS, este lee el imsmanifest.xml para conocer la estructura del curso y, al lanzar cada SCO, expone el API Adapter para que la Runtime API pueda funcionar. La guía completa sobre qué es SCORM y cómo funciona este proceso está disponible en: ¿Qué es SCORM? Guía completa para equipos de formación.

Limitaciones de la SCORM Runtime API

A pesar de su adopción generalizada, la SCORM Runtime API tiene limitaciones conocidas que conviene tener presentes al diseñar estrategias de formación:

• Solo funciona dentro del LMS: la API requiere que el curso se ejecute en un contexto de LMS que exponga el API Adapter. No es posible rastrear el aprendizaje fuera de la plataforma (en apps móviles nativas, redes sociales o sistemas de terceros).
• Comunicación síncrona en el navegador: la Runtime API opera exclusivamente en el navegador mediante JavaScript. Si el alumno cierra el navegador sin que el curso ejecute LMSFinish, los datos de la sesión pueden no guardarse.
• Modelo de datos limitado en SCORM 1.2: cmi.suspend_data tiene un límite de 4.096 caracteres, lo que puede ser insuficiente para cursos complejos con muchos estados internos.
• Sin soporte nativo para mobile offline o xAPI: para escenarios de aprendizaje fuera del LMS o en dispositivos sin conexión, el estándar xAPI (Tin Can) ofrece mayor flexibilidad al no depender de una API JavaScript en el navegador.

La SCORM Runtime API en las herramientas de autor: el papel de isEazy Author

Desde el punto de vista práctico, el L&D Manager no interactúa directamente con la SCORM Runtime API: esa responsabilidad recae en la herramienta de autor utilizada para crear los cursos. Una herramienta de autor bien implementada genera automáticamente el código SCORM correcto —incluyendo las llamadas a LMSInitialize, LMSSetValue y LMSFinish— sin que el diseñador instruccional tenga que preocuparse por la capa técnica.

isEazy Author publica cursos en formato SCORM 1.2 y SCORM 2004 con una implementación completa de la Runtime API: gestión correcta del estado de completado, envío de puntuación, guardado de marcadores de posición y compatibilidad verificada con los principales LMS del mercado. Esto garantiza que los datos de formación llegan al LMS de forma fiable, sin necesidad de configuración técnica adicional.

EMASESA, empresa de servicios de agua en Sevilla, utilizó isEazy Author para crear cursos SCORM en tiempo récord y publicarlos directamente en su LMS con un seguimiento preciso por parte del equipo de RRHH. El resultado: contenido e-learning producido de forma ágil con trazabilidad completa del progreso de los empleados.
Descubre cómo EMASESA creó cursos e-learning con isEazy →