SuperAPI AI 工具集

uloop-control-play-mode

通用与其它

查看项目

更新于 10-16 05:50

技能介绍

用途:通过 uloop 命令行控制 Unity 编辑器的播放模式,支持启动、停止、暂停、单帧步进,以及无副作用查询状态,便于对运行时行为进行验证。

用法:uloop control-play-mode [options]。参数 --action 可选 Play(开始)、Stop(停止)、Pause(暂停)、Step(暂停时前进一帧)、Status(仅报告状态,不做任何修改)、Resume(Play 的别名,各状态下行为相同,停止时也会启动);--timeout-seconds 默认 180,为等待目标状态的秒数。

输出:返回 JSON,包含 IsPlaying、IsPaused、Changed、WasAlreadyStopped、ResumedFromPause、Message,以及可选的 Warning、StoppedBy、StoppedAt。

行为要点:对已停止的编辑器执行 Stop 会返回 Changed: false、WasAlreadyStopped: true;对播放中的编辑器执行 Play 是空操作,不会重启会话;暂停中执行 Play 会恢复同一会话;Step 精确前进一帧并保持暂停,与 Time.timeScale 无关,且需播放模式运行中。命令会等待目标状态后返回,慢项目可增大超时。

限制与注意事项:Play 从编辑模式触发域重载,会丢弃热重载补丁和未用 --persist 启用的暂停点;未保存更改无法静默保存时(如无标题场景)Play 立即以 CONTROL_PLAY_MODE_UNSAVED_CHANGES 失败;Status 不做等待、不保存场景,也不受编译错误拒绝,但不会预测未保存更改的阻塞。验证前建议先用 uloop get-logs --log-type Error 检查既有错误。收费、价格与平台信息暂未提供。