william
c504ace167
SCORM/xAPI : - Ajoute l'export SCORM 2004 (3rd/4th edition) au choix, en plus du 1.2 par défaut : sépare completion_status/success_status (un échec reste "completed" au lieu de retomber à tort en "incomplete" comme force la 1.2), remonte aussi cmi.interactions.n.* par question répondue. - Fournit cmi.core.score.min/max (1.2 et 2004), calculé depuis les récompenses de quiz du jeu, pour que le LMS affiche un vrai pourcentage au lieu du score brut à tort étiqueté "%". - Libellés de verbes xAPI en français en plus de l'anglais. Accessibilité (RGAA/WCAG 2.1 AA) sur le player : - Navigation clavier des objets de scène "au clic"/"au survol" (tabindex, role, Entrée/Espace, focus/blur). - alt sur les images (nom auteur ou décoratif), aria-hidden sur les icônes seules, role="dialog"/aria-live sur les boîtes de dialogue/quiz. - Landmark <main> + titre de page, respect de prefers-reduced-motion. - Le quiz n'avance plus automatiquement après un délai fixe : bouton "Continuer →" explicite (RGAA 2.2.1). - Avertissement de contraste dans l'éditeur de style de dialogue. - Déclaration d'accessibilité téléchargeable depuis la modale d'export.
68 lines
3.7 KiB
Python
68 lines
3.7 KiB
Python
"""Déclaration d'accessibilité exportable (obligation légale RGAA pour
|
|
tout service numérique concerné, voir roadmap phase 1.2) — PAS un audit
|
|
certifié : un résumé honnête, généré à partir de ce que le moteur de jeu
|
|
implémente RÉELLEMENT aujourd'hui (voir static/js/play/triggers.js,
|
|
dialogue-box-controller.js, screens/scenes/render_scene_object.py), à
|
|
compléter/faire valider par le créateur du jeu avant publication."""
|
|
from datetime import date
|
|
|
|
_DECLARATION_TEMPLATE = """Déclaration d'accessibilité — {game_name}
|
|
Générée le {today} par Forge Engine
|
|
|
|
Cette déclaration résume l'état d'accessibilité du jeu de formation
|
|
"{game_name}" au regard du RGAA (Référentiel Général d'Amélioration de
|
|
l'Accessibilité, version française de WCAG 2.1 niveau AA). Elle décrit ce
|
|
que le moteur Forge Engine implémente pour TOUT jeu exporté — elle ne
|
|
remplace pas un audit RGAA complet réalisé par un expert accessibilité, et
|
|
ne couvre pas le contenu propre à ce jeu (texte, images, choix de
|
|
couleurs) qui reste sous la responsabilité de son créateur.
|
|
|
|
CRITÈRES PRIS EN CHARGE PAR LE MOTEUR
|
|
--------------------------------------
|
|
- Navigation clavier : tout objet de scène réagissant "Au clic" ou "Au
|
|
survol" est focusable (Tab) et activable au clavier (Entrée/Espace),
|
|
en plus de la souris. Les boutons de dialogue/quiz sont de vrais
|
|
<button> HTML.
|
|
- Lecteurs d'écran : les boîtes de dialogue et de quiz sont annoncées
|
|
(role="dialog", contenu dynamique signalé par aria-live). Les images de
|
|
personnages/décors reçoivent le nom donné par le créateur du jeu comme
|
|
alternative textuelle, ou sont marquées décoratives (alt="") si aucun
|
|
nom n'a été renseigné. Les icônes seules sont marquées décoratives.
|
|
- Structure de page : landmark <main> et titre de page (masqué
|
|
visuellement, lu par les lecteurs d'écran).
|
|
- Délai réglable : la révélation de la bonne réponse à une question de
|
|
quiz n'avance plus automatiquement après un délai fixe — l'apprenant
|
|
clique sur "Continuer →" quand il est prêt.
|
|
- Confort visuel : les animations en boucle infinie de l'interface
|
|
respectent le réglage système "Réduire les animations"
|
|
(prefers-reduced-motion).
|
|
- Contraste des couleurs : un avertissement est affiché au créateur du
|
|
jeu dans l'éditeur de style si le contraste texte/fond de la boîte de
|
|
dialogue/quiz est insuffisant (< 4.5:1) — un choix de couleurs reste
|
|
possible malgré l'avertissement, la vérification finale revient au
|
|
créateur du jeu.
|
|
|
|
POINTS RESTANT À LA CHARGE DU CRÉATEUR DE CE JEU
|
|
--------------------------------------------------
|
|
- Choisir des couleurs de texte/fond suffisamment contrastées (le
|
|
moteur avertit, mais n'empêche pas un choix insuffisant).
|
|
- Fournir des noms clairs aux personnages/décors qui portent une
|
|
information (le moteur ne peut pas deviner un contenu manquant).
|
|
- Ajouter des sous-titres/transcriptions à tout contenu audio ajouté au
|
|
jeu (hors du champ du moteur lui-même).
|
|
- Vérifier que le texte des scènes reste compréhensible sans dépendre
|
|
uniquement de la couleur ou de la position.
|
|
|
|
Cette déclaration a été générée automatiquement et n'engage que la
|
|
description de ce que le moteur Forge Engine implémente à la date
|
|
ci-dessus — elle ne constitue pas une certification de conformité RGAA
|
|
complète du jeu "{game_name}".
|
|
"""
|
|
|
|
|
|
def build_accessibility_declaration(game_name):
|
|
"""Texte brut (jamais de mise en forme HTML/Markdown à interpréter :
|
|
prévu pour être lu/imprimé/collé tel quel dans un document interne,
|
|
voir routes/publish/accessibility_declaration.py)."""
|
|
return _DECLARATION_TEMPLATE.format(game_name=game_name, today=date.today().isoformat())
|