Module 3.2 · Microressource 2

Importer un jeu dans Moodle (SCORM)

Pratique
Objectif pédagogique

Empaqueter le jeu au format SCORM et le déposer dans Moodle.

Votre jeu tourne sur votre poste. Déposé en simple ressource Fichier, il fonctionnerait d'ailleurs très bien — mais Moodle ne saurait absolument rien de ce qui s'y passe. SCORM change cela, et c'est tout ce qui le justifie.

1. Pourquoi SCORM plutôt qu'un simple fichier

Au module 3.1, nous avons déposé le cours en ressource Fichier : simple, fidèle, suffisant pour du texte. Le jeu, lui, produit un résultat — et c'est ce résultat qu'on aimerait récupérer.

Ressource FichierPaquetage SCORM
Le jeu s'affiche et fonctionneOuiOui
Moodle sait qui l'a ouvertNonOui
Le score remonte dans le carnet de notesNonOui
Achèvement d'activité automatiqueNonOui
Travail de préparationAucunUn manifeste et un zip
Si le suivi ne vous intéresse pas Déposez le jeu en ressource Fichier, comme le cours. C'est parfaitement valable pour une activité d'entraînement libre. SCORM n'a d'intérêt que si vous voulez savoir : qui a joué, combien de temps, avec quel résultat.

2. Ce qu'est un paquet SCORM

Rien de mystérieux : un fichier ZIP, contenant vos fichiers habituels plus deux pièces supplémentaires. La seule règle de forme qui compte est l'emplacement du manifeste.

jeu-scorm.zip
├── imsmanifest.xml   ← À LA RACINE du zip, jamais dans un sous-dossier
├── index.html        la page lancée au démarrage
├── jeu.css
├── jeu.js
└── scorm.js          le pont avec Moodle
L'erreur numéro un Compresser le dossier jeu au lieu de son contenu. Le manifeste se retrouve alors dans jeu/imsmanifest.xml, Moodle ne le trouve pas, et refuse le paquet. Cette exigence devra figurer noir sur blanc dans votre demande.

3. Les deux pièces à faire produire

Vous n'écrirez ni l'une ni l'autre : Claude Code s'en chargera. Mais vous devez savoir ce que chacune fait, sans quoi vous ne pourrez ni la demander correctement, ni vérifier ce que vous recevez.

imsmanifest.xml — la carte d'identité du paquet

C'est le fichier que Moodle ouvre en premier. Il ne contient aucun contenu pédagogique : il décrit le paquet. Sans lui, le dépôt est purement et simplement refusé.

Quatre informations y figurent, et ce sont les seules que vous aurez à décider :

  • La version de la norme

    SCORM 1.2 dans notre cas — la plus ancienne, la plus simple, et celle que tous les Moodle acceptent.

  • Le titre de l'activité

    C'est ce que lira l'étudiant en ouvrant l'activité dans son cours. La seule information réellement visible du manifeste.

  • Le fichier à ouvrir au lancement

    index.html dans la quasi-totalité des cas. C'est la porte d'entrée du jeu.

  • La liste de tous les fichiers du paquet

    Un par un. En oublier un, c'est risquer qu'il ne parte pas : une image absente, un style manquant, un jeu qui s'affiche de travers dans Moodle alors qu'il était parfait chez vous.

scorm.js — le pont avec Moodle

Un paquet SCORM s'affiche très bien sans ce fichier. Mais il ne remonterait rien — et vous auriez fait tout ce travail pour obtenir exactement ce qu'une ressource Fichier vous donnait gratuitement.

Son rôle : Moodle met à disposition de la page une sorte de guichet, et scorm.js est ce qui va lui parler. Il fait quatre choses.

Il faitCe que Moodle en retire
Trouver le guichet et ouvrir une sessionSait que l'étudiant a commencé, et quand
Envoyer un score en fin de partieInscrit la note dans le carnet de notes
Envoyer un statut réussi ou échouéPeut marquer l'activité comme achevée
Clôturer la session en quittantEnregistre, même si l'étudiant ferme l'onglet
L'exigence à ne pas oublier Hors de Moodle, ce guichet n'existe pas. scorm.js doit alors ne rien faire du tout, sans provoquer la moindre erreur : votre jeu doit rester jouable d'un double-clic, sur votre poste comme sur celui de vos étudiants. Si vous ne le précisez pas dans votre demande, vous obtiendrez un jeu qui ne fonctionne plus que dans Moodle.

4. Le prompt

Tout ce qui précède tient dans une seule demande. Elle a ceci de particulier qu'elle ne décrit aucun code : elle énonce ce que chaque pièce doit faire, et les deux ou trois contraintes qui font la différence entre un paquet accepté et un paquet refusé.

Charpente — à compléter avant de l'envoyer
Prépare le paquet SCORM du jeu qui se trouve dans le dossier jeu/.

LE MANIFESTE
- Crée jeu/imsmanifest.xml, conforme à la norme SCORM 1.2.
- Titre de l'activité, celui que verra l'étudiant :
  [votre titre]
- Fichier lancé au démarrage : index.html
- Déclare TOUS les fichiers du dossier jeu/, sans en oublier un seul.

LE PONT AVEC MOODLE
- Crée jeu/scorm.js : le minimum pour dialoguer avec Moodle en SCORM 1.2.
- Il doit ouvrir une session au chargement de la page, envoyer en fin
  de partie un score de 0 à 100 et un statut réussi ou échoué, puis
  clôturer la session quand on quitte — y compris si l'étudiant ferme
  simplement l'onglet.
- IMPÉRATIF : hors de Moodle, scorm.js ne doit rien faire et ne
  provoquer aucune erreur. Le jeu doit rester jouable par double-clic.

LE BRANCHEMENT
- Charge scorm.js avant jeu.js dans jeu/index.html.
- À la fin de chaque partie, envoie une note de 0 à 100 calculée à
  partir du résultat de la simulation : [ce qui fait une bonne note
  et ce qui la fait chuter]. Statut réussi si [votre critère].
- Affiche cette note dans le débrief, pour que l'apprenant la voie.
- Ne change ni le modèle, ni l'interface.

LE PAQUET
- Produis jeu-scorm.zip en compressant LE CONTENU du dossier jeu/,
  et non le dossier lui-même : imsmanifest.xml doit se retrouver à la
  racine du zip.
- Liste-moi ensuite ce que contient le zip, fichier par fichier.

Explique-moi en quelques lignes ce que fait scorm.js et comment tu as
calculé la note.

Trois points à contrôler dans ce que vous recevez, avant même d'aller dans Moodle :

  • Le jeu s'ouvre toujours en double-clic

    Le test le plus rapide, et celui qui échoue le plus souvent. Si la page reste blanche, scorm.js n'a pas été rendu inoffensif hors Moodle.

  • Le zip contient bien le manifeste à sa racine

    Ouvrez-le : imsmanifest.xml doit apparaître au premier niveau, pas dans un dossier jeu.

  • La liste des fichiers est complète

    Comparez la liste annoncée avec le contenu réel de votre dossier jeu/. Un fichier oublié dans le manifeste est un fichier qui manquera.

5. Déposer dans Moodle et vérifier

  1. Ajouter l'activité

    Mode édition activé, Ajouter une activité ou ressource, puis Paquetage SCORM.

  2. Déposer le zip

    Glissez jeu-scorm.zip dans la zone Fichier du paquetage. Si Moodle refuse le dépôt, le manifeste n'est pas à la racine : relisez la section 2.

  3. Régler l'affichage

    Dans Apparence, affichage Nouvelle fenêtre si le jeu a besoin de place, Fenêtre courante sinon. Désactivez la table des matières : il n'y a qu'une activité dans le paquet.

  4. Vérifier la note

    Jouez une partie en Prendre le rôle… → Étudiant, puis ouvrez le carnet de notes. Votre score doit y figurer. C'est le seul test qui prouve que le pont fonctionne.

Mettre à jour un paquet déjà déposé Vous corrigez le jeu, vous faites régénérer le zip, vous remplacez le fichier dans l'activité existante. Les notes déjà enregistrées sont conservées — inutile de recréer l'activité.
Ce qu'il faut avoir compris
  • SCORM n'a d'intérêt que pour le suivi : sinon, la ressource Fichier suffit.
  • Un paquet SCORM est un zip avec imsmanifest.xml à sa racine.
  • Le manifeste décrit le paquet : titre, fichier de lancement, liste complète des fichiers.
  • scorm.js fait remonter le score — et doit rester inoffensif hors de Moodle.
  • On n'écrit pas ces fichiers : on sait ce qu'ils font, et on les fait produire.
Et maintenant

Le cours se lit, le jeu se joue et se note. Reste la troisième tuile : le quiz, et les questions à faire entrer dans Moodle.

Module 3.3 — Faire un quiz et importer ses questions →