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, mais le clic lecture/pause reste géré sur web/standalone.
`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))

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_v reste 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.

Retrouvez nous sur le discord Make&Play