Différences

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

--- en:yaml:medias [2026/05/03 18:29] – Add English wiki page using real engine keys cyrilfiesta
+++ en:yaml:medias [2026/08/31 21:22] (Version actuelle) – Wiki : fins de pages homogènes, liens Discord retirés cyrilfiesta
@@ Ligne 1: / Ligne 1: @@
-**Language:** [[fr:yaml:medias|Français]] | **English**
+**Language / Langue :** [[fr:yaml:medias|FR]] | **EN**
 ====== Sounds, Images and Videos (YAML) ======
@@ Ligne 50: / Ligne 50: @@
 | ''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 58: @@
 ((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 92: @@
   ((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.