内联视频：规则与示例

内联视频是放置在文章阅读流程中的托管或外部嵌入录制内容，用于演示、说明或记录一个独立的主题。它包含可见标签、精心设计的海报帧、播放控件、字幕、时长和完整的转录文本。没有这些周边文字，未标记的播放器对每一位无法观看或选择不看的读者来说都是隐形的——对于提取文本而非解码录制的系统而言也近乎空无一物。

待定的海报备注是截图规范，而非资源引用。周围的 HTML 在媒体制作完成之前展示了所需的阅读顺序。

为什么此元素很重要

当动作、时序、语音或随时间的变化承载含义时，视频可以降低解释成本。读者可以看到菜单如何打开、实体产品如何移动、或演讲者如何对结论加以限定。观看需要注意力、声音或字幕、时间，并且通常比阅读消耗更多流量，因此清晰的标签和时长让读者能够判断这一成本。

海报帧在播放之前影响这一决策。具有代表性的静止画面充当了录制内容视觉承诺的作用。而包含闭眼、加载转圈或无关标题卡的随机帧则显得内容粗心大意，迫使读者通过播放来发现其主题。海报应展示视频实际解释的状态、人物、对象或结果。

机器可提取性是软件在不重现其呈现方式的情况下恢复内容单元含义的能力。裸露的 iframe 通常只暴露提供方 URL。带标签的元素则暴露标题、摘要、时长、日期、海报、字幕、转录文本和稳定标识符。搜索、翻译、无障碍和检索系统因此能够理解这一独立的解释。

因此，转录文本是元素的一部分，而非可选的下载内容。它按文档顺序保留口语声明、说话者变化、有意义的音效和视觉动作。字幕支持播放体验；转录文本支持页面。遵循共享的元素编写规则 ，了解语义优先级、指令语法和正文映射。本页面在其要求转录文本、海报、时长和视频特定无障碍字段时具有优先权。

何时使用

当基于时间的证据比静态图像和文字更能清晰地说明一个独立观点时，使用内联视频。适用场景包括：界面操作、实体技术、可见转换、专家讲解、依赖动作的产品行为，或交付本身就是证据的录制结果。

在委托录制之前进行替代测试。如果一张截图和两句话能同样好地解释观点，就使用它们：它们加载更快、扫描更快、更新成本更低。当顺序、节奏、动作、语音或观察到的行为改变理解时，视频才有其用武之地。

接近但不适用的情况包括：

• 不相关段落中的长网络研讨会： 链接到专门的视频页面或使用完整的视频嵌入区域。内联元素必须服务于局部论点，而不是引入一小时的周边主题内容。
• 静音循环装饰： 这属于动态设计，而非编辑性视频。将其移除或视为具有减少动作行为的装饰性媒体。
• 用屏幕录制替代操作说明： 用文字写出步骤和成功状态。视频可以演示它们，但不能成为完成任务的唯一方式。
• 脱离上下文的客户引述剪辑： 只有披露了说话者、关系、录制日期、认可和周边主张时，短片才能支持案例研究。
• 唯一价值在于个性的视频： 仅当语音、表达方式或说话者的权威性相关时使用。不要让读者观看已经出现在页面上的文案朗读。
• 多个同类短片： 当任务是在多个录制内容中进行选择时，使用画廊或专门的媒体区域。不要堆叠内联播放器。

放置位置

将视频紧接在说明读者将学习或观察到的内容的段落之后。将其标题、时长和摘要放在播放器之前。将转录文本直接放在其后，仅当完整文本以 HTML 形式存在（不含播放代码）时方可折叠。

在流程中，将播放器放在书面的操作序列之后、故障排除之前。读者应能够不观看即可操作，然后使用录制内容确认动作或界面状态。在论证或案例研究中，在录制内容之前陈述主张，并在其后解释其局限性。

不要将其放在另一个播放器、自动播放动画、大型行动号召、表单或计算器旁边。竞争的控件会造成焦点不清。不要将其放入表格单元格、列表项、提示框、选项卡、轮播、折叠面板或可点击卡片中。转录文本可以使用披露控件；但整个视频不能。

将标题、摘要、海报、播放器、时长、转录文本控件和署名保留在一个 figure 边界内。来源说明可以紧随其后。切勿用广告、推广或不相关章节将播放器与其转录文本分开。

结构

1. 可见标题： 以具体的 HTML 文本命名任务、演示、事件或主张。
2. 摘要： 用一句话说明读者将看到什么以及为什么重要。
3. 时长： 在播放前以分钟和秒显示观看成本。
4. 海报帧： 展示具有代表性的、经批准的帧，而不单独假装成按钮。
5. 播放器控件： 提供播放、暂停、搜索、音量、全屏、播放速度和字幕访问。
6. 字幕： 将对话、说话者变化和有意义的非语音音频与播放同步。
7. 转录文本： 以可选中、可搜索的 HTML 文本形式复现完整的有意义序列。
8. 视觉描述： 记录旁白未说明的屏幕上意义明确的动作或变化。
9. 署名和来源： 在相关时标识说话者、创作者、录制日期或证据来源。

标题不是文件名，摘要也不是"请观看下方视频"。每一部分在脱离播放器复制时仍必须保持有用。

设计示例

所有变体共享相同的内容契约。交付方式变化；但标签、字幕、转录文本质量、播放许可和阅读顺序不变。

托管演示

当机构控制编码、字幕、海报选择及可用性时，使用第一方 HTML5 播放器播放简短的产品或流程录制。

注重隐私的外部嵌入

当需要外部平台的交付、分析或已有渠道时使用。在政策要求时仅在获得同意后才加载提供方，在激活前标识提供方，并保留本地转录文本，即使提供方移除了录制内容。

简短界面剪辑

使用简洁的剪辑演示一个难以用静态图像传达的状态变化。它仍然需要控件、暂停机制、有意义的文本描述和转录文本；不要将其变成自动循环的 GIF。

采访或证据剪辑

当作者身份、措辞或观察到的证词重要时，使用以说话者为主导的剪辑。以 HTML 格式显示人物姓名和角色，披露编辑情况，并转录语音和有形视觉证据。

参数

这些字段构成可移植的内容契约。宽度、边框、阴影、播放按钮样式和断点行为属于渲染器。

正文中的第一个标题映射到 title；第一个段落映射到 summary；剩余正文映射到 transcript。对于连续的单说话者说明，转录时间范围为可选；对于流程、说话者变化和超过两分钟的录制内容，建议使用时间范围。autoplay、loop 和背景音频字段有意不包含在内。

语法和代码示例

每种表示法保留相同的标题、摘要、媒体元数据、字幕和转录文本。示例域描述的是契约，而非生产环境资产引用。

可移植 Markdown 指令

:::inline-video{src="https://media.example.com/freshness-filter.mp4" provider=hosted poster="https://media.example.com/freshness-filter-poster.webp" duration="PT1M30S" captions="https://media.example.com/freshness-filter.en.vtt" language=en uploadDate="2026-08-27"}
## 筛选需要审核的页面

了解如何应用需要审核筛选器并验证生成的工作队列。

**00:00–00:18 — 打开报告。** 从审计中打开新鲜度。

**00:19–00:54 — 应用筛选器。** 打开状态并选择需要审核。

**00:55–01:30 — 验证队列。** 确认每个可见行都有预期状态。
:::

Hugo 短代码

{{< inline-video src="https://media.example.com/freshness-filter.mp4" provider="hosted" poster="https://media.example.com/freshness-filter-poster.webp" duration="PT1M30S" captions="https://media.example.com/freshness-filter.en.vtt" language="en" uploadDate="2026-08-27" >}}
## 筛选需要审核的页面

了解如何应用需要审核筛选器并验证生成的工作队列。

**00:00–00:18 — 打开报告。** 从审计中打开新鲜度。

**00:19–00:54 — 应用筛选器。** 打开状态并选择需要审核。

**00:55–01:30 — 验证队列。** 确认每个可见行都有预期状态。
{{< /inline-video >}}

这是预期的适配器契约，而非声称本地短代码已存在。它仅使用命名参数。在注册渲染器之前，使用语义化的 figure、video、track 和 transcript HTML，保留相同字段。

WordPress 块

<!-- wp:amicited/inline-video {"src":"https://media.example.com/freshness-filter.mp4","provider":"hosted","poster":"https://media.example.com/freshness-filter-poster.webp","duration":"PT1M30S","captions":"https://media.example.com/freshness-filter.en.vtt","language":"en","uploadDate":"2026-08-27"} -->
<h2>筛选需要审核的页面</h2>
<p>了解如何应用需要审核筛选器并验证生成的工作队列。</p>
<video controls preload="metadata" poster="https://media.example.com/freshness-filter-poster.webp">
  <source src="https://media.example.com/freshness-filter.mp4" type="video/mp4">
  <track kind="captions" srclang="en" src="https://media.example.com/freshness-filter.en.vtt" label="English" default>
</video>
<details><summary>阅读转录文本</summary><p><strong>00:00–00:18 — 打开报告。</strong>从审计中打开新鲜度。</p><p><strong>00:19–00:54 — 应用筛选器。</strong>打开状态并选择需要审核。</p><p><strong>00:55–01:30 — 验证队列。</strong>确认每个可见行都有预期状态。</p></details>
<!-- /wp:amicited/inline-video -->

如果已注册的 WordPress 块不可用，请使用原生视频、标题、段落和详情块。不要粘贴 iframe 而省略本地转录文本。

示例

好：带有阅读替代方案的有界演示

筛选需要审核的页面 · 1:30

该视频展示一个任务：打开新鲜度报告、应用状态筛选器、检查结果数量。其海报展示打开的筛选器，字幕准确标识界面标签，三段式转录文本记录每个操作和成功检查。播放仅在激活后开始。

这样做是因为读者可以预测价值和耗时，可以带声音观看、带字幕观看，也可以从转录文本中完成相同任务。录制内容提供了动作和状态变化证据，而不成为唯一的操作说明。

坏：无标签播放器

观看此内容 第三方 iframe 在标题下方自动加载。其海报是黑色帧，未显示时长，字幕由提供方生成且未经审核，页面不包含转录文本或摘要。

坏的版本让每位不观看的读者只能猜测。它不给提取器提供主题，要求注重隐私的读者在选择播放前联系提供方，在录制内容消失时没有持久的文本，并可能将不正确的字幕作为事实呈现。通过使用具体标题和摘要、精心设计的海报、时长、知情同意加载、经审核的字幕、完整的本地转录文本以及在播放器之外书写的任务或主张来修复它。

模式标记与无障碍

内联视频不会自动创建模式标记的资格。仅当页面直观地提供了可访问录制内容的准确 name、description、thumbnailUrl、uploadDate、duration 以及 contentUrl 或 embedUrl 值时，才使用 VideoObject。切勿为了满足验证器或标记装饰性剪辑为主要视频而虚构字段。

当页面本身符合条件时，相关视频可以支持符合条件的 Article、HowTo 或 Product。其转录文本不能证明可见页面中不存在的主张或步骤。

无障碍始于播放之前。标记 figure，以文本形式显示标题和时长，为控件提供键盘操作和可见焦点。切勿自动播放。提供暂停、搜索、音量、速度、字幕和全屏功能。不要将焦点困在第三方播放器中；全屏关闭后，将其返回到启动控件。

字幕必须同步、标点正确并与录制内容对照审核。当声音不明显时识别说话者，并在影响理解时包含有意义的音效，如"[通知音]"。当有意义的视觉信息未在主音频中说明时，需要音频描述；仅凭描述性转录文本并不能使定时的播放体验等价。

转录文本必须是逻辑顺序的真实 HTML——而非画布、仅播放内容、隐藏文本或仅 PDF 下载。披露控件需要可访问的名称和展开状态。播放器和转录文本必须在 200% 缩放和窄宽度下正常工作，不会产生页面级别的水平滚动。

编写规则

播放器周围的文字决定了视频是内容元素还是未说明的对象：

• 编写 4–12 个词的具体标题。命名任务、演示、说话者、事件或发现；切勿单独使用"视频"、“观看此内容"或"了解更多”。
• 编写一句 15–35 词的摘要，告诉读者发生了什么以及为什么重要。不要重复标题。
• 保持内联录制内容聚焦，通常不超过五分钟。硬上限为 20 分钟；更长的录制内容应属于专用页面或需要进行编辑分段。
• 在播放前显示时长。可见文本使用 M:SS，结构化字段使用 ISO 8601，如 PT1M30S。
• 选择以正常显示尺寸代表主题的海报。避免空白帧、转圈画面、意外表情、欺骗性播放按钮、微小的界面文本以及未经批准的个人或客户信息。
• 对照最终版本审核字幕。修正姓名、产品标签、数字、领域术语、标点、说话者变化和有意义的音效。
• 转录所有有意义的语言和视觉内容。摘要、章节标题和自动生成的字幕文件不能替代转录文本。
• 使用简短的转录文本段落、必要时使用说话者标签，并在流程阶段或主题变化处使用时间范围。不要从意译的语音中制造引述。
• 说明可能改变解读的编辑内容。不要拼接推荐语、实验或演示，使时序暗示不支持的结果。
• 将关键的操作说明、价格、警告、资格条件、证据和行动号召保留在录制内容之外。读者不能为了找到重要事实而必须拖动时间线。
• 切勿在元素内放置自动播放、闪烁内容、背景音频、转化覆盖层、需解锁的转录文本字段或第二个播放器。
• 记录媒体所有者及审核触发器。当界面、政策、产品行为、说话者归属或周边主张发生变化时，重新检查视频。

使用该元素的文章类型

postTypes 前置元数据数组驱动此矩阵。允许使用内联视频的前提是基于时间的证据能增加含义；并不要求每个页面都有播放器。

质检清单

• 视频增加了静态图像和简洁文字无法同等传达的基于时间的含义。
• 可见标题具体命名录制内容，摘要在播放前解释其价值。
• 时长在读者激活播放器之前显示。
• 海报具有代表性、可辨认、经批准，且不含私人或误导性内容。
• 播放不会自动开始、意外循环或在无读者操作时产生声音。
• 播放、暂停、搜索、音量、速度、字幕和全屏控件通过键盘和触控工作。
• 字幕与最终编辑版本一致，并正确保留姓名、数字、说话者变化和有意义的音效。
• 未通过语音传达的有意义的视觉内容获得音频描述或等效的替代版本。
• 完整的转录文本是可选择的 HTML，遵循录制内容的顺序，并描述必要的视觉动作。
• 书面操作说明、警告、条件、证据和行动号召保持在视频之外可用。
• 外部提供方加载遵循适用的同意规则，且在激活前标识提供方。
• 播放器、标签和转录文本保持在一个语义化的 figure 中，不被不相关内容打断。
• 元素未嵌套在表格、列表、提示框、选项卡、轮播、折叠面板或可点击容器中。
• 录制内容和转录文本在 200% 缩放、窄宽度、减少动作以及无仅 JavaScript 含义的情况下工作。
• 任何 VideoObject 字段与可见、可验证的媒体元数据及可访问的录制内容匹配。
• 所选文章类型出现在 postTypes 中，且放置位置与上述矩阵匹配。
• 媒体所有者、权利、录制日期以及审核或替换条件已记录。

常见问题

每个内联视频都需要转录文本吗？

是的。字幕用于同步播放；转录文本用于阅读、扫描、搜索、翻译、引用、无障碍和提取。它必须包含完整的有意义内容，包括语音未说明的视觉动作。

海报帧中可以包含视频标题吗？

可以，但相同的标识信息也必须以 HTML 文本形式出现。海报文本可能在小屏幕上不可读、在图片加载失败时不可用，且对不解释像素的软件不可访问。

内联视频应该自动播放吗？

不。自动播放消耗流量、中断阅读、引入未经请求的动作或声音，并剥夺读者选择何时参与的权利。仅在明确激活后开始播放。

字幕和转录文本是一回事吗？

不。字幕与播放同步，包含相关的音效提示。转录文本是一种持久的阅读替代方案，按录制内容的时序组织，并附有对有意义的视觉内容的必要描述。

内联视频需要 VideoObject 模式标记吗？

不。仅当准确的可见元数据和稳定的录制内容支持时，才添加 VideoObject。缺少可信的名称、描述、海报、上传日期、时长和媒体 URL 的播放器不应生成不完整或虚构的标记。