**Language / Langue :** **FR** | [[en:yaml:medias|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 :

<code yaml>
texte: |
  Le dragon rugit ! <<https://exemple.com/sons/rugissement.mp3>>
  Vous subissez 10 dégâts.
</code>

Formats supportés par le linter et les exports : ''.mp3'', ''.ogg'', ''.wav'', ''.flac'', ''.m4a''.

**Jouer N fois** (0 = boucle infinie) :
<code yaml>
<<3:https://exemple.com/sons/alarme.mp3>>
<<0:https://exemple.com/sons/musique.mp3>>
</code>

**Stopper tous les sons** :
<code yaml>
<<stop>>
</code>

  * 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 ''%%]]%%'' :

<code yaml>
texte: |
  [[https://exemple.com/images/chateau.png]]
</code>

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 [[fr:yaml:texte|Texte et formatage]].

===== Vidéos (v4.10) =====

Entourez l'URL avec ''%%((%%'' et ''%%))%%'' :

<code yaml>
texte: |
  ((https://exemple.com/videos/intro.mp4))
</code>

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

<code yaml>
((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))
</code>

Les vidéos fonctionnent aussi dans les **encadrés HUD** (''encadre:''). Voir [[fr:yaml:hud|HUD]].

===== Variables dans les URLs (v4.10) =====

Dans les URLs de sons, images et vidéos, utilisez ''{nom_variable}'' pour construire un chemin dynamique :

<code yaml>
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))
</code>

  * 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 =====

<code yaml>
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é."
</code>

Si la description est uniquement une URL image ''%%[[url]]%%'', ''examiner <objet>'' affiche l'image directement.

**Retrouvez nous sur le [[https://discord.gg/Z63DtVV|discord Make&Play]]**