Table des matières
Language / Langue : FR | EN
Sons, images et vidéos (YAML)
Les médias se placent directement dans les textes narratifs, les descriptions d'objets et les encadrés HUD.
Sons
Entourez l'URL avec << et >> pour jouer un son :
texte: | Le dragon rugit ! <<https://exemple.com/sons/rugissement.mp3>> Vous subissez 10 dégâts.
Formats supportés par le linter et les exports : .mp3, .ogg, .wav, .flac, .m4a.
Jouer N fois (0 = boucle infinie) :
<<3:https://exemple.com/sons/alarme.mp3>>
<<0:https://exemple.com/sons/musique.mp3>>
Stopper tous les sons :
<<stop>>
- Un nouveau son arrête le précédent.
- Sur Discord, le bot tente de rejoindre le salon vocal JDR-Bot s'il existe.
- Des sons libres de droits sont disponibles : https://cyril-fiesta.fr/jdr-bot/scenarios/sounds/
Images
Entourez l'URL avec [[ et ]] :
texte: | [[https://exemple.com/images/chateau.png]]
Formats supportés : .png, .jpg, .jpeg, .gif, .webp, .svg selon le navigateur/adaptateur.
Si le contenu entre [[ et ]] n'est pas une URL d'image, il est rendu comme un encart texte. Voir Texte et formatage.
Vidéos (v4.10)
Entourez l'URL avec (( et )) :
texte: | ((https://exemple.com/videos/intro.mp4))
Formats reconnus : .mp4, .webm, .mov, .ogv.
Si le contenu ne ressemble pas à une vidéo valide, il reste affiché comme du texte normal avec ses parenthèses.
Options vidéo
Les options se placent avant l'URL, séparées par ; puis par : :
| Option | Effet |
|---|---|
loop | Lecture en boucle. |
autoplay | Lecture automatique ; le moteur force aussi muted pour respecter les navigateurs. |
muted | Son coupé. |
controls ou controls=true | Affiche les contrôles vidéo. C'est le comportement par défaut. |
controls=false | Masque les contrôles. Pour un fichier, le clic lecture/pause reste géré sur web et standalone. Pour une vidéo hébergée, la lecture démarre seule, sans son : une iframe ne se pilote pas au clic. |
poster=url_image | Image d'attente avant lecture. Les variables {nom} sont acceptées. |
((loop:https://exemple.com/videos/ambiance.mp4)) ((autoplay;muted:https://exemple.com/videos/intro.mp4)) ((poster=https://exemple.com/poster.jpg;loop:https://exemple.com/videos/scene.mp4)) ((controls=false;loop;muted:https://exemple.com/videos/bg.mp4))
Vidéos hébergées
La même syntaxe (( )) accepte aussi un lien YouTube, Vimeo, Dailymotion ou PeerTube. Le lecteur du service remplace le lecteur intégré, au même emplacement et avec la même apparence qu'une vidéo ordinaire.
((https://www.youtube.com/watch?v=aqz-KE-bpKQ)) ((https://vimeo.com/76979871)) ((https://framatube.org/w/mnRs2Wm5cGqXcHbF))
Les formes courtes et variantes sont reconnues : youtu.be, /shorts/, m.youtube.com, dai.ly, player.vimeo.com, ainsi que les deux formes PeerTube (/videos/watch/ et /w/) sur n'importe quelle instance.
Un lien vers une chaîne ou une playlist est refusé : l'adresse doit désigner une vidéo précise. Le linter le signale.
Vie privée. YouTube est appelé via son domaine sans cookie et Vimeo reçoit dnt=1, sans que l'auteur ait à l'écrire.
Options. loop, autoplay, muted et controls=false sont traduites vers les paramètres propres à chaque service. Deux exceptions :
- Dailymotion les ignore toutes : depuis la migration de son lecteur, un embed sans Player ID se lit avec ses réglages par défaut. Le linter vous prévient plutôt que de laisser croire au réglage.
poster=est sans effet sur une vidéo hébergée : le service affiche sa propre miniature. Cela reste valable pour un fichier.
Autres supports. Discord et le Terminal affichent le lien, ce dernier nommant aussi la plateforme. Dans un export HTML5, la vidéo reste en ligne : elle n'est pas embarquée dans l'archive et le rapport ne la signale pas comme manquante. L'export doit donc être servi en HTTP ou HTTPS, les lecteurs hébergés ne fonctionnant pas depuis une page locale file://.
Les vidéos fonctionnent aussi dans les encadrés HUD (encadre:). Voir HUD.
Variables dans les URLs (v4.10)
Dans les URLs de sons, images et vidéos, utilisez {nom_variable} pour construire un chemin dynamique :
texte: | [[https://monsite.fr/images/{zone}.png]] <<https://monsite.fr/sons/{ambiance}.mp3>> ((poster=https://monsite.fr/posters/{clip}.jpg:https://monsite.fr/videos/{clip}.mp4))
- Fonctionne avec les variables numériques, textuelles et online, par exemple
{piste_o}. - Si la variable est inconnue,
{nom}reste tel quel dans l'URL. - La syntaxe
v_nom_vreste réservée au texte narratif ; pour les URLs, utilisez les accolades.
Médias dans les descriptions d'objets
objets: - nom: carte endroit: table description: "Une carte du royaume.\n[[https://exemple.com/images/carte.png]]" msg_ramassage: "Vous prenez la carte." - nom: cle_musicale endroit: coffre description: "Une clé qui sonne. <<https://exemple.com/sons/cle.mp3>>" msg_ramassage: "Vous prenez la clé."
Si la description est uniquement une URL image [[url]], examiner <objet> affiche l'image directement.
