SuperAPI AI 工具集

uloop-replay-input

测试与质量

查看项目

更新于 10-16 05:50

技能介绍

用途:在 Unity PlayMode 中回放已录制的键盘与鼠标输入,用于精确复现玩法、E2E 运行或一致的演示。

主要能力:从 JSON 录制文件逐帧注入输入(通过 Input System,零 CLI 开销),支持循环回放和进度监控。录制需在 Unity 编辑器中通过 Window > Unity CLI Loop > Recordings 使用 Start Recording 和 Stop Recording 创建;没有用于录制输入的 CLI 命令。

使用方式:启动回放(自动检测最新录制):uloop replay-input --action start;指定文件:uloop replay-input --action start --input-path scripts/my-play.json;循环回放:uloop replay-input --action start --loop;查看进度:uloop replay-input --action status;停止:uloop replay-input --action stop。

参数:--action 枚举,默认 start,可选 start、stop、status;--input-path 字符串,默认自动,为空时自动检测 .uloop/outputs/InputRecordings/ 中最新的录制;--no-show-overlay 标志,隐藏回放进度覆盖层;--loop 标志,持续循环。

输出:返回 JSON,包含 Success、Message、Action、InputPath(仅 start 时填充)、CurrentFrame、TotalFrames、Progress(0.0–1.0)、IsReplaying。

限制与前提:Unity 必须处于 PlayMode;必须安装 Input System 包(com.unity.inputsystem),本工具仅适用于新 Input System。回放会逐帧注入完全相同的输入,但游戏本身也须具备确定性才能产生一致结果;若需跨运行比较回放输出,请先阅读 references/deterministic-replay.md 再解释失败。