如何用 player-only 参数把 Midscene 报告播放器嵌入到其他页面

如何用 player-only 参数把 Midscene 报告播放器嵌入到其他页面【免费下载链接】midsceneGUI Agent for E2E Testing项目地址: https://gitcode.com/GitHub_Trending/mid/midsceneMidscene 每次运行 Agent 后都会生成一个自包含的 HTML 报告文件默认写在当前工作目录的midscene_run/report/下里面记录了完整的执行历史并内置回放播放器。如果你想在另一个网页里只展示回放播放器——例如放进iframe而不想让访客看到报告的顶栏、任务侧边栏、时间线和详情面板——可以给报告 URL 追加player-only1查询参数页面就会剥掉所有外围界面只保留播放器。本文覆盖三个查询参数player-only、play-control、auto-play的取值规则、一条典型嵌入写法、深链到具体步骤的锚点用法以及嵌入后如何判断配置是否生效。适用前提是你已经通过 Midscene如midscene/web等平台包或对应 CLI跑出了 HTML 报告文件并可以把它部署到某个可访问的地址上。报告文件本身的生成与拆分方式可参考 consume-report-file.md。三个查询参数各控制什么参数解析逻辑实现在 player-only.ts官方说明见 FAQ中文版同样有。三个参数作用互不相同参数取值默认行为作用player-only只认1关闭隐藏全部外围界面顶栏、侧边栏、时间线、详情面板只保留回放播放器play-control只认1隐藏在 player-only 模式下显示底部播放控制条auto-play0关闭其他值含缺省开启开启页面加载后是否自动开始播放。独立于player-only对每个报告播放器都生效有两点取值规则容易踩坑单测 player-only.test.ts 明确覆盖了它们player-only和play-control是仅1生效的开关?player-onlytrue、?player-onlyon、?player-only2、?player-only01以及不带等号的裸标志?player-only都不会启用该模式。auto-play则是除0外都视为开启?auto-play0关闭自动播放?auto-play1、?auto-play无值或参数缺失时都会自动播放。参数解析源码还给出了一个完整的示例组合report.html?player-only1play-control1auto-play0。嵌入到其他页面最短主路径把报告文件放到可访问的静态地址然后在报告 URL 后拼上查询参数。FAQ 给出的典型嵌入写法是https://your-report-host/midscene_run/report/index.html?player-only1play-control1其中your-report-host与报告路径替换为你自己部署报告文件后的实际地址。在承载页里用iframe引这个 URL 即可iframe srchttps://your-report-host/midscene_run/report/index.html?player-only1play-control1 width800 height600 /iframe如果不想加载后立刻自动播放再追加auto-play0。这个参数与是否嵌入无关——对任意嵌入或未嵌入报告...?auto-play0都会让打开时不自动播放。深链到具体某一步player-only可以和#task-id哈希锚点组合直接打开某个任务的播放器。FAQ 给出的示例https://your-report-host/midscene_run/report/index.html?player-only1#task-0-5即深链到task-0-5这一步并只展示它的播放器。不带锚点时报告默认以回放全部模式打开整条流程动画。验证嵌入效果仓库里的 e2e 用例 player-only.yaml 就是一条现成的核对清单它用demo.html?player-only1play-control1auto-play1打开报告然后断言页面呈现——整个视图只填充一个视频/回放播放器底部有播放进度条和时间显示没有 Midscene 顶栏、左侧任务侧边栏也没有 Record 时间线区块。对照自己的嵌入页检查这几点就能确认player-only模式已经生效若底部出现了控制条说明play-control1也生效了不加该参数时控制条默认隐藏。反过来如果页面仍显示顶栏和侧边栏先检查 URL 里的参数是不是精确的player-only1而不是true、on等别名这是最常见的未生效原因。限制与边界深链到的某个步骤如果没有回放动画例如它不是一个可回放的 Planning 步骤播放器不会显示空白页而是显示No replay available for this step.的提示见 App.tsx 中 player-only 渲染分支。play-control只在 player-only 模式中有意义不加player-only1时它不改变完整报告视图。auto-play的开关逻辑与其他两个参数不同它是默认开、0关而非仅1开在给嵌入页拼 URL 时不要把三者用同一套取值习惯处理。【免费下载链接】midsceneGUI Agent for E2E Testing项目地址: https://gitcode.com/GitHub_Trending/mid/midscene创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考