Web-Presentation

Appearance

WP07：媒体用途与活动页会话 ​

状态：待验收（会话与单测完成，真实浏览器联调并入 WP12）。阶段：M1。主责：Runtime。

前置与输入 ​

前置完成：WP04、WP06。

修改范围与交付 ​

  • 扩展 PageMediaSession target 状态，读取 data-runtime-media-purpose，未标记媒体按 content 兼容。
  • 为每个稳定的真实放映页创建会话，不再只在 advance.mode=media_end 时创建。
  • 保留 generation 围栏、MutationObserver、原生事件和 play Promise 作为真实状态来源。
  • 区分“参与完成判定”“具备自动播放资格”“仅受暂停/清理管理”三个维度，避免用 loop 或 autoplay 属性替代语义。
  • 检测多个 narration 目标并返回有界错误，不同时播放。

完成标准 ​

  • [x] content/narration、loop、动态增删和元素换源有单测。
  • [x] 旧页面的 audio/video 行为不变，未声明 purpose 时兼容。
  • [x] dispose 后旧 generation 事件不会进入新页面。
  • [x] 本包不接页面 ready 自动播放，也不修改推进策略。

建议提交标题：WP07：扩展活动页媒体用途与会话。

实施记录 ​

  • 代码版本：本工作包所在提交。
  • 已实现：PageMediaSession 读取元素或祖先的 data-runtime-media-purpose，拆出 participating、autoplayEligible 和用途三维状态；循环媒体不参与完成，旁白循环或多旁白进入有界 contractError，冲突旁白不参与完成且不自动播放。MutationObserver 同时观察 loop 与 purpose，元素换源、动态增删和旧 generation 事件沿用原围栏。
  • 已运行：
    • pnpm exec vitest run src/core/media/page-media-session.test.ts：19 项通过。
    • Runtime 全量 pnpm exec vitest run：148 个文件、1178 项通过、3 项跳过（2026-10-18）。
    • pnpm --filter web-runtime-vue check 与触碰文件 ESLint：通过。
  • 未运行：真实 Chromium/Firefox/WebKit 的旁白用途与动态 DOM 行为，留到 WP12。