Différences

Ci-dessous, les différences entre deux révisions de la page.

--- en:yaml:medias [2026/05/03 18:47] – Harmonize FR/EN language switch cyrilfiesta
+++ en:yaml:medias [2026/09/06 19:04] (Version actuelle) – 4.14 : le texte TTS est lu sans affichage hors Discord cyrilfiesta
@@ Ligne 14: / Ligne 14: @@
 Supported formats for linting and exports: ''.mp3'', ''.ogg'', ''.wav'', ''.flac'', ''.m4a''.
+Without an audio extension, the content of ''%%<<…>>%%'' is read aloud without being displayed:
+<code yaml>
+text: "<<Welcome to the adventure!>>"
+</code>
+Discord uses native TTS messages, which remain visible; Web, Desktop and standalone exports use the device's speech synthesis without displaying the content. The Terminal has no speech synthesis and ignores it. To display the text too, write it normally in addition to the tag.
 <code yaml>
@@ Ligne 50: / Ligne 56: @@
 | ''muted'' | Muted audio. |
 | ''controls'' or ''controls=true'' | Show controls. Default. |
-| ''controls=false'' | Hide controls; click play/pause still works on web/standalone. |
+| ''controls=false'' | Hide controls. For a file, click play/pause still works on web and standalone. For a hosted video, playback starts on its own, muted: an iframe cannot be controlled by a click. |
 | ''poster=url'' | Poster image before playback. URL variables are accepted. |
@@ Ligne 58: / Ligne 64: @@
 ((poster=https://example.com/poster.jpg;loop:https://example.com/videos/scene.mp4))
 </code>
+===== Hosted videos =====
+The same ''%%(( ))%%'' syntax also accepts a link to YouTube, Vimeo, Dailymotion or PeerTube. The service player replaces the built-in one, in the same place and with the same appearance as an ordinary video.
+<code yaml>
+((https://www.youtube.com/watch?v=aqz-KE-bpKQ))
+((https://vimeo.com/76979871))
+((https://framatube.org/w/mnRs2Wm5cGqXcHbF))
+</code>
+Short and alternate forms are recognised: ''youtu.be'', ''/shorts/'', ''m.youtube.com'', ''dai.ly'', ''player.vimeo.com'', and both PeerTube forms (''/videos/watch/'' and ''/w/'') on any instance.
+A link to a channel or a playlist is refused: the address must point to one precise video. The linter reports it.
+**Privacy.** YouTube is called through its cookie-free domain and Vimeo receives ''dnt=1'', with nothing to write on the author side.
+**Options.** ''loop'', ''autoplay'', ''muted'' and ''controls=false'' are translated into the parameters of each service. Two exceptions:
+  * **Dailymotion ignores them all**: since its player migrated, an embed without a Player ID plays with its default settings. The linter warns you instead of letting you believe the setting applies.
+  * ''poster='' has no effect on a hosted video: the service shows its own thumbnail. It still works for a file.
+**Other platforms.** Discord and the Terminal display the link, the Terminal also naming the platform. In an HTML5 export the video stays online: it is not embedded in the archive, and the report does not list it as missing. The export must therefore be served over HTTP or HTTPS, since hosted players do not work from a local ''%%file://%%'' page.
 ===== Variables in URLs =====
@@ Ligne 69: / Ligne 98: @@
   ((poster=https://site.test/posters/{clip}.jpg:https://site.test/videos/{clip}.mp4))
 </code>
+===== Media inside object descriptions =====
+<code yaml>
+objects:
+  - name: map
+    location: table
+    description: "A map of the kingdom.
+[[https://example.com/images/map.png]]"
+    pickup_text: "You take the map."
+  - name: musical_key
+    location: chest
+    description: "A key that rings. <<https://example.com/sounds/key.mp3>>"
+    pickup_text: "You take the key."
+</code>
+When the description is only an image URL ''%%[[url]]%%'', ''inspect <object>'' shows the picture directly.