**Language / Langue :** [[fr:yaml:medias|FR]] | **EN**

====== Sounds, Images and Videos (YAML) ======

Media can be used in narrative text, object descriptions and HUD panels.

===== Sounds =====

<code yaml>
text: |
  The dragon roars! <<https://example.com/sounds/roar.mp3>>
  You take 10 damage.
</code>

Supported formats for linting and exports: ''.mp3'', ''.ogg'', ''.wav'', ''.flac'', ''.m4a''.

<code yaml>
<<3:https://example.com/sounds/alarm.mp3>>
<<0:https://example.com/sounds/music.mp3>>
<<stop>>
</code>

===== Images =====

<code yaml>
text: |
  [[https://example.com/images/castle.png]]
</code>

Supported formats include ''.png'', ''.jpg'', ''.jpeg'', ''.gif'', ''.webp'' and ''.svg'' depending on the adapter/browser.

===== Videos (v4.10) =====

<code yaml>
text: |
  ((https://example.com/videos/intro.mp4))
</code>

Recognized formats: ''.mp4'', ''.webm'', ''.mov'', ''.ogv''.

If the content does not look like a valid video, it remains normal text with its parentheses.

===== Video Options =====

Options go before the URL, separated with '';'' then '':''.

^ Option ^ Effect ^
| ''loop'' | Loop playback. |
| ''autoplay'' | Autoplay; the engine also forces ''muted''. |
| ''muted'' | Muted audio. |
| ''controls'' or ''controls=true'' | Show controls. Default. |
| ''controls=false'' | Hide controls; click play/pause still works on web/standalone. |
| ''poster=url'' | Poster image before playback. URL variables are accepted. |

<code yaml>
((loop:https://example.com/videos/ambience.mp4))
((autoplay;muted:https://example.com/videos/intro.mp4))
((poster=https://example.com/poster.jpg;loop:https://example.com/videos/scene.mp4))
</code>

===== Variables in URLs =====

Use ''{variable_name}'' inside sound, image and video URLs.

<code yaml>
text: |
  [[https://site.test/images/{zone}.png]]
  <<https://site.test/sounds/{ambience}.mp3>>
  ((poster=https://site.test/posters/{clip}.jpg:https://site.test/videos/{clip}.mp4))
</code>