沉浸式视频画廊（Expose 风格）

需要 plate 像 Live Photo 一样呈现时用沉浸式视频：先看到封面静图，视频就绪后再进入静音循环。这仍是同一套文件夹 ::gallery 模型——不是新的 contentType，也不包含 Expose 多边形 / 空间叠加范围。

需要包含 cover+video 沉浸的 Web Device 运行时（arc#3764）。旧构建仍会展开 ::gallery{folder} 并显示封面，但可能不会切到视频。先升级服务端 ARC，再把「只有静图」当成样例损坏。

定尺寸 plate（ratio / width / height）需要含 sized-plate CSS 的运行时；旧构建保持全视口 stage。参数细则：文件夹媒体画廊。

什么时候用

最小示例

::gallery{folder="plates" layout="expose"}

文内方块 plate（阅读栏内，不必整屏滚动）：

::gallery{folder="plates" layout="expose" ratio="1:1"}

本页样例在 ./plates/，封面与视频随仓库发布（无外链）。许可说明见 plates/_ATTRIBUTION.md。

写法：layout

沉浸来自文件夹里的 封面 + 视频配对，不是另一套 layout 引擎。

浏览布局（grid / mosaic / pair / masonry / film）以及没有视频兄弟的静图 large / stage，仍见文件夹媒体画廊。若浏览布局遇到视频文件，配对规则仍适用；沉浸交互按 stage / expose / story 设计。

写法：plate 尺寸

Stage 默认全视口。文内 demo（方形 Live Photo、16 hero、固定高度）可任选组合：

只写 ratio 时，宽默认 min(100%, 36rem)。完整参数与错误场景见：文件夹媒体画廊 — 定尺寸 plate。

封面 + 视频配对

同名（Live Photo 式）

静图与视频共用文件名主干：

plates/
  01-bay.jpg
  01-bay.mp4
  01-bay.md          # 可选 sidecar

视频扩展名包括 mp4、webm、mov（与封面同名主干）。图片扩展名与画廊静图集合一致（jpg / jpeg / png / webp 等）。

封面是画廊排序与配文的 plate 成员；同名视频是该 plate 的沉浸运动层。

Sidecar video: / poster:

无法同名（或资源改名）时，在 plate sidecar 里声明配对：

---
title: Bay
overlay: bottom-left
tone: dark
video: clips/bay-loop.mp4
poster: covers/bay.jpg
---

Optional second line on the plate.

video: / poster: 路径在画廊文件夹下解析（条目本地），与其他画廊媒体相同——不是站点级 content/media/。

每个 plate 用同名或显式 sidecar 之一，保持一种清晰配对，方便作者与审阅在文件夹里核对合同。

预期运行时行为

本页演示去掉了音轨，静音循环即全部表现；带音轨的片源可以发布——预期是 Unmute，而不是带声自动播放。

与其他画廊模式的区别

不要把 Expose 多边形蒙版、多层空间叠加或独立「expose contentType」写进 ::gallery——超出本块范围。

可运行样例

以下均使用本页的 folder="plates"。

文件夹成员：

Expose 定尺寸方块（ratio="1:1"）

文内 demo：同一配对，约束尺寸。

::gallery{folder="plates" layout="expose" ratio="1:1"}

先显示封面静图；有配对视频时，运行时无缝切入静音循环。

Expose 全视口（layout="expose"）

::gallery{folder="plates" layout="expose"}

先显示封面静图；有配对视频时，运行时无缝切入静音循环。

Stage（同样沉浸；expose 是别名）

::gallery{folder="plates" layout="stage"}

先显示封面静图；有配对视频时，运行时无缝切入静音循环。

Story（滚动 plate；配对规则相同）

::gallery{folder="plates" layout="story"}

先显示封面静图；有配对视频时，运行时无缝切入静音循环。

应看到的效果（arc#3764+）： plate 01–03 先封面再静音循环视频；plate 04 保持静图。叠加标题来自 sidecar。定尺寸方块样例把同样沉浸收进阅读栏盒子。旧版 ARC 仍会渲染封面与静图；运动或定尺寸可能要等运行时升级后才出现。

错误与空状态

边界

相关