Rastreio xAPI

Visão geral

O Creator pode reportar a atividade do formando como declarações xAPI (Experience API / Tin Can) a qualquer Learning Record Store (LRS) compatível com o standard. Cada interação relevante — responder a uma pergunta, terminar um jogo, passar um questionário, concluir uma lição ou o curso inteiro — torna-se numa declaração do tipo "Alex respondeu à Pergunta 3 (correto)".

O rastreio xAPI está disponível em três modos de entrega:

ModoPacoteComo o LRS é contactado
SCORM + xAPIExportação LMS (SCORM) com a opção Registar eventos xAPI ativadaEndpoint do LRS e credenciais incorporados no momento da exportação; o pacote continua a reportar SCORM ao LMS como habitualmente
Web + lançamento TinCanExportação Web com xAPI ativadoO endpoint, as credenciais e o ator chegam como parâmetros de consulta no URL de lançamento (estilo TinCan/Rustici); os valores incorporados são o mecanismo de reserva
Pacote xAPIO formato de exportação dedicado xAPI (Tin Can)Inclui um manifesto tincan.xml para que plataformas com suporte LRS (por exemplo, SCORM Cloud) possam importá-lo e lançá-lo; os parâmetros de lançamento têm prioridade sobre os valores incorporados

O que é reportado

As declarações são geradas a partir de modelos por brick, com valores por defeito sensatos por categoria:

  • Bricks de avaliação (escolha única, correspondência, preencher o espaço em branco…) — answered com o resultado (correto/incorreto). Ativado por defeito.
  • Jogos casuais (wordle, memória, jogo da forca…) — attempted na primeira interação, completed com o resultado. Ativado por defeito.
  • Média (vídeo, áudio) e coleções interativas (acordeão, separadores, carrosséis…) — experienced / interacted. Desativado por defeito — ative-os por brick onde o sinal é relevante.
  • Estrutura — sempre reportada enquanto o xAPI está ativo: initialized / completed / terminated do curso, completed da lição, e passed / failed do questionário com a pontuação do motor de questionários.

Personalização por brick

Abra o painel de edição de um brick e encontre a secção Rastreio xAPI (disponível em bricks de avaliação, jogo, média e coleção):

  • Reportar declarações — Por defeito (categoria), Ativado ou Desativado para este brick.
  • Verbo — escolha da lista standard de verbos ADL, ou selecione Verbo personalizado… para fornecer o seu próprio IRI de verbo e nome a apresentar (para organizações com o seu próprio perfil xAPI).
  • Nome da atividade — o nome legível apresentado nos relatórios do LRS (por defeito, o tipo de brick).

Pré-visualizar declarações

A Pré-visualização do editor executa o motor xAPI completo contra um LRS simulado incorporado. Abra o painel Declarações xAPI na pré-visualização e interaja com o conteúdo: cada declaração que o pacote exportado enviaria aparece em tempo real — sem necessidade de LRS nem de rede.

IRIs de atividade

As declarações identificam sobre o que se atuou através de IRIs hierárquicos fixados no pacote no momento da exportação:

{app-url}/xapi/content/{contentId}                     ← curso
{app-url}/xapi/content/{contentId}/lesson/{lessonId}   ← lição
{app-url}/xapi/content/{contentId}/lesson/{id}/brick/{brickId}

Os bricks referenciam a sua lição e curso através de contextActivities, para que os painéis do LRS possam agrupar a atividade por lição e curso. Estes IRIs são um contrato estável: reexportar o mesmo conteúdo mantém os mesmos IRIs, e o relatório do LRS mantém-se contínuo entre versões.

Credenciais do LRS

Quando incorpora um endpoint e credenciais de LRS no momento da exportação, estes ficam escritos no pacote (content.json) e são legíveis por qualquer pessoa que consiga abrir o zip — isto é inerente aos pacotes xAPI do lado do cliente, e é a prática standard de qualquer ferramenta de autoria de referência. Proteja-se:

  • Utilizando credenciais de LRS apenas de escrita (declarações a entrar, sem leituras).
  • Preferindo o modo de lançamento TinCan, onde a plataforma de alojamento injeta credenciais de curta duração por formando.

Identidade do formando

O ator em cada declaração é resolvido por ordem de prioridade:

  1. O ator do URL de lançamento TinCan (fornecido pela plataforma de alojamento).
  2. O id de formando SCORM da sessão do LMS (modo SCORM + xAPI), reportado como um identificador account.
  3. Um id anónimo persistido único por navegador — utilizado quando um pacote Web é aberto diretamente.
Monitorização xAPI