SCORM Runtime API

O que e a SCORM Runtime API?

A SCORM Runtime API e a interface de programacao JavaScript que permite a comunicacao em tempo real entre um curso de e-learning e o LMS (Learning Management System) que o hospeda. E o mecanismo tecnico que torna possivel que o LMS registre automaticamente o progresso do aluno, sua pontuacao, o tempo dedicado e o status de conclusao do curso.

No contexto do e-learning corporativo, a SCORM Runtime API e a ponte invisivel que conecta o conteudo formativo com a plataforma de gestao. Sem ela, o LMS nao teria como saber se um colaborador concluiu um modulo de onboarding, quanto tempo dedicou a um treinamento obrigatorio ou qual nota obteve em uma avaliacao.

Como funciona a SCORM Runtime API na pratica

Quando um aluno inicia um curso SCORM a partir do seu LMS, e acionada uma sequencia de comunicacoes definida pelo SCORM Runtime Environment (RTE). O curso — denominado tecnicamente SCO (Sharable Content Object) — localiza um objeto JavaScript chamado API ou API_1484_11 exposto pelo LMS na janela pai ou no frame contenedor.

Uma vez localizado esse objeto, o SCO pode chamar as funcoes da API para iniciar a sessao, recuperar dados anteriores do aluno, salvar seu progresso e encerrar a comunicacao corretamente ao final. Esse processo ocorre de forma transparente para o usuario e garante que todos os dados de treinamento sejam registrados no LMS independentemente do dispositivo ou navegador utilizado.

A especificacao diferencia duas versoes com nomes de funcao ligeiramente distintos: o SCORM 1.2 usa o prefixo LMS (ex.: LMSInitialize), enquanto o SCORM 2004 elimina esse prefixo (ex.: Initialize, GetValue).

As 8 funcoes principais da SCORM Runtime API

Tanto o SCORM 1.2 quanto o SCORM 2004 definem exatamente 8 funcoes obrigatorias que todo LMS compativel com SCORM deve implementar. Essas funcoes formam o contrato tecnico entre o curso e a plataforma:

O modelo de dados CMI: que informacoes a SCORM Runtime API rastreia?

A SCORM Runtime API nao define apenas as funcoes de comunicacao, mas tambem o modelo de dados CMI (Computer-Managed Instruction), que determina quais variaveis podem ser trocadas entre o curso e o LMS. Esses elementos de dados representam as informacoes realmente registradas em cada sessao de treinamento.

Os elementos mais relevantes para a gestao de treinamento corporativo sao:

• cmi.core.lesson_status — Status do curso: passed, failed, completed, incomplete, browsed ou not attempted.
• cmi.core.score.raw — Pontuacao numerica obtida pelo aluno.
• cmi.core.session_time — Tempo investido na sessao atual.
• cmi.core.lesson_location — Marcador de posicao (bookmark) para retomar o curso de onde parou.
• cmi.core.student_name — Nome do aluno, fornecido pelo LMS no inicio da sessao.
• cmi.suspend_data — Campo livre que o curso pode salvar para uso interno (estados de atividades, respostas anteriores etc.).

No SCORM 2004, o modelo de dados e significativamente ampliado, permitindo registrar respostas a interacoes individuais (cmi.interactions), objetivos de aprendizagem alcancados (cmi.objectives) e estados de competencia mais granulares.

O que a SCORM Runtime API significa para os responsaveis pelo treinamento

Para um profissional de L&D ou gestor de treinamento, entender a SCORM Runtime API tem implicacoes praticas diretas, mesmo que nao seja necessario escrever uma linha de codigo:

• Compatibilidade com o LMS: para que o rastreamento funcione, o LMS deve implementar corretamente o API Adapter. Um LMS compativel com SCORM garante que as 8 funcoes da API estejam disponiveis para todos os cursos publicados nesse padrao.
• Qualidade dos relatorios: se a ferramenta de autoria usada para criar os cursos nao chamar corretamente o LMSSetValue ou nao executar o LMSCommit antes de fechar, o LMS pode nao registrar o status de conclusao mesmo que o aluno tenha concluido o conteudo.
• Retomada de cursos: a capacidade de continuar um curso a partir do ultimo ponto visitado depende de o SCO salvar corretamente o cmi.core.lesson_location via LMSSetValue. Se o seu modelo de curso nao implementar isso, os alunos sempre comecarao do inicio.
• Diagnostico de problemas: quando um curso nao registra conclusoes ou nao envia pontuacoes, a causa geralmente esta em uma falha da API — um LMS que nao expoe o API Adapter corretamente ou um curso que nao chama o LMSFinish ao ser fechado.

SCORM Runtime API no SCORM 1.2 vs. SCORM 2004

As duas versoes principais do padrao compartilham a mesma logica da Runtime API, mas diferem nos nomes das funcoes e nas capacidades do modelo de dados. A escolha entre elas depende do nivel de detalhe de rastreamento que sua organizacao precisa e da compatibilidade do seu LMS.

O SCORM 1.2 continua sendo o padrao mais utilizado em ambientes corporativos globalmente: sua simplicidade e a ampla compatibilidade com qualquer reprodutor SCORM o mantêm como primeira opcao em muitas organizacoes. O SCORM 2004 adiciona sequenciamento condicional avancado e um modelo de dados mais granular, mas requer LMS e ferramentas de autoria com suporte explicito para as suas quatro edicoes.

Para uma analise comparativa detalhada entre as duas versoes, consulte nosso guia: SCORM 1.2 vs. SCORM 2004: qual escolher?

A relacao entre a SCORM Runtime API e o pacote SCORM

A SCORM Runtime API e apenas um dos tres componentes tecnicos que formam o padrao SCORM completo. Para entender o conjunto, e util distingui-los:

• Content Aggregation Model (CAM): define como o conteudo e empacotado em um arquivo ZIP com o arquivo imsmanifest.xml que descreve a estrutura do curso.
• Runtime Environment (RTE): o componente que contem a SCORM Runtime API. Define como o LMS lanca o conteudo e como o SCO se comunica com ele durante a execucao.
• Sequencing and Navigation (S&N): exclusivo do SCORM 2004, define as regras de navegacao condicional entre SCOs.

Quando um pacote SCORM e importado em um LMS, a plataforma le o imsmanifest.xml para conhecer a estrutura do curso e, ao lancar cada SCO, expoe o API Adapter para que a Runtime API possa funcionar. O guia completo sobre o que e o SCORM e como esse processo funciona esta disponivel em: O que e SCORM? Guia completo para equipes de treinamento.

Limitacoes da SCORM Runtime API

Apesar de sua adocao generalizada, a SCORM Runtime API tem limitacoes conhecidas que vale considerar ao desenhar estrategias de treinamento:

• Funciona apenas dentro do LMS: a API exige que o curso seja executado em um contexto de LMS que exponha o API Adapter. Nao e possivel rastrear o aprendizado fora da plataforma (em aplicativos moveis nativos, redes sociais ou sistemas de terceiros).
• Comunicacao sincrona no navegador: a Runtime API opera exclusivamente no navegador via JavaScript. Se o aluno fechar o navegador sem que o curso execute o LMSFinish, os dados da sessao podem nao ser salvos.
• Modelo de dados limitado no SCORM 1.2: o cmi.suspend_data tem um limite de 4.096 caracteres, o que pode ser insuficiente para cursos complexos com muitos estados internos.
• Sem suporte nativo para mobile offline ou xAPI: para cenarios de aprendizado fora do LMS ou em dispositivos sem conexao, o padrao xAPI (Tin Can) oferece maior flexibilidade, pois nao depende de uma API JavaScript no navegador.

A SCORM Runtime API nas ferramentas de autoria: o papel do isEazy Author

Do ponto de vista pratico, o gestor de L&D nao interage diretamente com a SCORM Runtime API — essa responsabilidade recai sobre a ferramenta de autoria utilizada para criar os cursos. Uma ferramenta de autoria bem implementada gera automaticamente o codigo SCORM correto — incluindo as chamadas a LMSInitialize, LMSSetValue e LMSFinish — sem que o designer instrucional precise se preocupar com a camada tecnica.

O isEazy Author publica cursos nos formatos SCORM 1.2 e SCORM 2004 com uma implementacao completa da Runtime API: gestao correta do status de conclusao, envio de pontuacao, salvamento de marcadores de posicao e compatibilidade verificada com os principais LMS do mercado. Isso garante que os dados de treinamento cheguem ao LMS de forma confiavel, sem necessidade de configuracao tecnica adicional.

A EMASESA, empresa de servicos de agua de Sevilha, utilizou o isEazy Author para criar cursos SCORM em tempo recorde e publicalos diretamente em seu LMS com rastreamento preciso pela equipe de RH. O resultado: conteudo de e-learning produzido de forma agil com total visibilidade do progresso dos colaboradores.
Descubra como a EMASESA criou cursos de e-learning com a isEazy →