SCORM player: come visualizzare un pacchetto SCORM e risolvere gli errori

Cos'è un player SCORM

Quando in un LMS clicchi su un corso e questo si apre, quello che stai usando è il player: carica l'index del pacchetto, inizializza la connessione con le API di tracciamento e da quel momento registra ciò che il corso comunica — avanzamento, punteggio, completamento. Cosa contenga esattamente un pacchetto è spiegato nella guida a SCORM.

Come aprire un file SCORM (con e senza LMS)

Un file SCORM è uno ZIP: il doppio clic non lo "apre" nel senso utile del termine. Le strade sono tre, in ordine di completezza:

• Dentro un LMS — la via normale: si carica il pacchetto come attività e il player integrato fa tutto. Come farlo su Moodle e le altre piattaforme è coperto nella guida a SCORM e LMS;
• Con un player online — per test e verifiche senza piattaforma: SCORM Cloud di Rustici offre un piano gratuito pensato esattamente per questo, e riporta anche i dati di tracciamento in tempo reale — utilissimo per capire se un problema sta nel pacchetto o nell'LMS;
• Aprendo l'index nel browser — decomprimendo lo ZIP e aprendo il file di avvio si vede il contenuto, ma senza alcun tracciamento: il corso cercherà le API SCORM, non le troverà, e a seconda di com'è fatto mostrerà un errore o proseguirà in modalità degradata. Va bene solo per un'occhiata ai contenuti.

Modulo SCORM bloccato: cause e soluzioni

"Il modulo risulta bloccato" è il sintomo più cercato e ha quasi sempre una di queste tre origini:

1. Un tentativo precedente rimasto aperto

Se una sessione si è chiusa male — scheda chiusa a metà corso, connessione caduta — l'LMS può considerare il tentativo ancora in corso e impedirne uno nuovo. La soluzione è lato piattaforma: chiudere o azzerare il tentativo dal registro dell'attività (su Moodle: report dell'attività SCORM → eliminazione dei tentativi dell'utente).

2. Prerequisiti e criteri di completamento

Il modulo può essere bloccato per progetto: prerequisiti non soddisfatti (un modulo precedente non completato) o criteri configurati nell'LMS che non combaciano con ciò che il pacchetto invia — il classico corso che manda passed mentre la piattaforma aspetta completed. In questi casi il blocco si risolve nella configurazione dell'attività, non nel pacchetto.

3. Il browser — e il caso Safari

Popup bloccati e cookie di terze parti disabilitati impediscono al player di aprire o tracciare il contenuto. Safari merita una nota a parte: le sue protezioni (ITP) trattano con particolare severità i contenuti in iframe provenienti da domini diversi da quello della piattaforma — lo scenario tipico quando l'LMS serve i contenuti da un CDN o sottodominio separato. I sintomi: il corso si apre ma non salva l'avanzamento, oppure resta bloccato al caricamento. Le vie d'uscita: consentire i cookie cross-site per il dominio della piattaforma, usare un browser diverso, o — lato piattaforma — servire i contenuti dallo stesso dominio dell'LMS.

Il pacchetto non parte: checklist tecnica

Contenuti 3D e WebGL che non caricano

Un caso a parte — e in crescita — riguarda i pacchetti SCORM che contengono applicazioni 3D: simulazioni Unity WebGL, ambienti interattivi, serious game. Qui ai problemi classici se ne aggiungono di specifici: build pesanti che superano i limiti di upload dell'LMS, compressione (Brotli/Gzip) che richiede header corretti dal server della piattaforma, memoria del browser insufficiente su macchine datate, e la gestione degli input dentro l'iframe — mouse e tastiera catturati dalla simulazione mentre la pagina ospite deve continuare a scorrere normalmente.

Sono problemi risolvibili, ma vanno affrontati in fase di build, non dopo: ottimizzazione degli asset, configurazione della compressione, e un layer di integrazione SCORM scritto per il contenuto specifico. È il lavoro che facciamo sui progetti Unity WebGL + SCORM — e quando il tracciamento richiesto va oltre ciò che SCORM sa registrare, entra in gioco xAPI.

Domande frequenti