Médias et supports visuels
Vous pouvez donner à une leçon les figures, équations, cartes conceptuelles, photographies et courts extraits audio ou vidéo qui aident les étudiants à raisonner, chacun avec sa source et ses droits consignés. Vous préparez les médias réutilisables une fois ; un étudiant peut aussi demander un nouveau support à son assistant pendant une séance. L'objectif d'apprentissage, l'attribution et la réponse propre de l'étudiant restent toujours séparés des médias, et aucun modèle d'image, d'audio ou de vidéo n'est nécessaire pour terminer une activité.
Le skill studium-visual-support guide un assistant dans ce travail
(voir skills). Les options de langue et la notation scientifique côté
étudiant sont dans langue et supports.
Ce qui fonctionne aujourd'hui
| Besoin | État |
|---|---|
| Figures, SVG, équations, graphiques, tableaux, spectres, molécules 3D, audio, vidéo | Le contrat des ressources de leçon (render_assets) ; le panneau VS Code en affiche le plus large éventail, les autres surfaces moins : testez celle que vous utilisez |
| Une figure locale dans un dossier de leçon | Résolue depuis le dossier de la leçon ; un fichier situé hors de ce dossier, même par un lien symbolique, est refusé : copiez-le dans assets/ |
| Diagrammes Mermaid | Rendus localement dans les modèles d'activités (--supports) ; affichés en texte source dans MySTRA |
| Une nouvelle image pendant une séance | Seulement si l'assistant de l'étudiant dispose réellement d'un outil d'image |
| Supports générés d'après l'historique d'un étudiant | Non implémenté ; le contexte public de la scène exclut cet historique |
Trois sortes de figures
Figure de source. Conservez le fichier, sa légende, le DOI ou l'identifiant de capsule, la page et le panneau, et tout recadrage. Notez provenance et statut de réutilisation avant d'en distribuer une copie. Une lecture multimodale d'une figure reste une interprétation à vérifier.
Graphique calculé. Tracez-le à partir des données réellement utilisées, avec script, paramètres,
unités et contrôles. Utilisez un outil de tracé ou un plot_spec quand les valeurs exactes comptent.
Gardez les échecs et les résultats nuls.
Support explicatif généré. Une carte conceptuelle, une analogie visuelle ou un résumé schématique peut synthétiser une difficulté. Signalez-le comme généré et conservez la source originale à part : des pixels générés ne sont ni une mesure, ni une validation, ni un résultat de capsule.
examples/visual-support/figure-asset.json montre
une ressource image à placer dans scene.render_assets, le vrai fichier étant dans le dossier
assets/ de la leçon.
examples/visual-support/concept-map.mmd est une
carte conceptuelle Mermaid ; son texte sert aussi d'alternative accessible. Là où aucun moteur Mermaid
n'est disponible, livrez une image PNG passive rendue à partir d'elle et gardez le .mmd à côté.
Différencier sans étiqueter les étudiants
Utilisez deux axes indépendants : la familiarité avec le domaine et la familiarité avec la méthode ou l'outil. Un court résumé dans les mots de l'étudiant suffit souvent : « Je connais les spectres, je découvre les réseaux moléculaires, je confonds similarité et identité. » Si l'assistant ne fait que supposer une difficulté, il la présente comme une hypothèse et la vérifie par une courte question.
| Situation | Support possible | Vérification suivante |
|---|---|---|
| Axes ou unités mal lus | Figure originale avec repères textuels et un exemple simple | Lire un autre point ou panneau |
| Similarité confondue avec identité | Carte des relations et contre-exemple sourcé | Dire ce que le score ne prouve pas |
| Méthode difficile à suivre | Schéma des entrées, opérations et sorties | Repérer où intervient une hypothèse |
| Grande familiarité | Vue compacte, hypothèses et cas limites | Une nouvelle variation choisie par l'étudiant |
Un format préféré n'est pas un « style d'apprentissage » fixe, et les erreurs ne doivent pas devenir un profil médical ou psychologique. Ne modifiez jamais le barème en silence.
Préparer des médias pour un cours
Choisissez le rôle avant le format :
| Rôle | Exemple | Placement |
|---|---|---|
| Observation première | Photographie d'un objet archéologique | before_prediction |
| Orientation | Courte introduction sans la réponse | before_prediction |
| Explication | Carte conceptuelle, schéma annoté, analogie commentée | after_prediction (par défaut) |
Une photographie, son annotation et une reconstitution générée sont des objets différents ; une reconstitution ne doit jamais passer pour une preuve documentaire.
- Choisissez la source et l'intention, examinez l'image réelle ou écoutez l'extrait en entier, et rédigez une alternative textuelle utile.
- Écrivez un fichier de supports :
kind(image,audiopour WAV ou MP3,videopour MP4 ou WebM),path,provenance,meta.altetmeta.placement;meta.originvautsourceougenerated. - Pour l'audio et la vidéo, ajoutez
meta.rights(creator,license,evidence_url,scope=private,courseoupublic) etmeta.transcript; la vidéo exige aussi unmeta.captions_pathWebVTT etmeta.captions_language. - Construisez l'activité avec
--supports SUPPORTS.json(voir modèles d'activités) et relisez le résultat avant la séance.
Les chemins des médias doivent rester sous le dossier du fichier de supports. Limites : 5 Mio par image, 20 Mio par fichier audio ou vidéo et 30 Mio au total. Les contrôles portent sur les signatures de fichiers, les métadonnées et la taille, pas sur la vérité scientifique, la libération des droits ni la compatibilité des codecs. L'exemple archéologique montre une photographie de musée placée avant la prédiction.
Un étudiant demande un nouveau support
.venv/bin/python tools/media_workflow.py prepare \
--activity ACTIVITY --brief examples/media/teacher-brief.json --out ACTIVITY/media-request.json
La demande ne dépend d'aucun fournisseur : une consigne, la sortie attendue, une alternative
textuelle et les références des sources, liées à l'identité et à l'empreinte de l'activité, plus une
copie .txt à télécharger. Elle ne lit aucun fichier privé de l'apprenant et n'appelle aucun modèle.
L'assistant vérifie de quels outils de génération il dispose réellement, ne transmet que le contexte
nécessaire, jamais l'historique privé ni les clés de réponse, et consigne l'outil et la consigne
effectivement utilisés dans le reçu d'exploration. Après relecture de la sortie :
.venv/bin/python tools/media_workflow.py attach --request ACTIVITY/media-request.json \
--media RETURNED_FILE.png --source-metadata SOURCE_METADATA.json --out ENRICHED_ACTIVITY
Ajoutez --transcript pour l'audio ou la vidéo et --captions pour la vidéo. Le rattachement écrit un
nouveau dossier avec la même identité d'activité et consigne les empreintes du parent, de la demande et
du média ; l'activité d'origine et les fichiers de l'apprenant restent intacts. Une séance déjà ouverte
dans le navigateur n'est pas rechargée : exportez d'abord sa trace.
Accessibilité et droits
Les lecteurs ont des commandes natives, sans lecture automatique ni préchargement ; un média généré porte un avertissement visible sur ses inexactitudes possibles. Proposez une image fixe ou une version texte et gardez les consignes essentielles hors du média. N'inférez ni handicap ni trait durable à partir d'une seule erreur. Sous-titres et transcriptions aident, mais n'établissent pas la conformité : faites relire par de vrais utilisateurs, avec les recommandations du W3C sur l'accessibilité des médias.
Les champs de droits sont un enregistrement consultable, pas une certification juridique. L'usage
privé n'est pas une exemption générale : en France, l'exception de copie privée suppose notamment une
source licite et un usage strictement privé, et la diffusion à un cours relève d'un autre périmètre
(article L122-5 du Code de la propriété intellectuelle).
Une source avec license: "unknown" et scope: "private" consigne une incertitude ; elle n'autorise
ni à la publier ni à l'envoyer à un fournisseur de modèles.
Vérifier les médias dans le navigateur
pnpm --filter @studium/activity-presentation build
.venv/bin/python tools/prepare_media_audit.py --out .studium-session/media-check
node tools/audit-media-presentation.mjs .studium-session/media-check/activity .studium-session/media-check/audit
Il faut ffmpeg et Playwright avec Chrome. La commande construit une activité avec une photographie de
musée et de courts extraits synthétiques, puis vérifie lecture, sous-titres, placement, téléchargement
de la consigne et mise en page dans report.json. Elle ne génère aucun extrait par IA et n'évalue pas
l'apprentissage. Utilisez un nouveau dossier de sortie à chaque fois.