用途:通过 unity-cli 查找、检查和交互 Unity 的 uGUI / UI Toolkit 元素,是面向 UI 的技能,与 unity-playmode-testing(完整运行时控制)互补。
适用场景:需要按名称或类型定位 UI 元素;需要在交互前后检查 UI 状态;需要点击 UI 元素、设置数值或运行一段简短的 UI 输入序列。
不适用场景:仅做通用 Play Mode 设置而无 UI 定位需求时,应使用 unity-playmode-testing;需要创建 UI 预制体或场景层级时,应使用 unity-scene-create 或 unity-prefab-workflow。
推荐流程:先用 namePattern 或 elementType 定位目标;操作前先检查当前状态(可见性、可交互性);每次只执行一个交互,若顺序重要则重新检查状态;仅当 UI 依赖运行时状态时,才与 unity-playmode-testing 组合使用。
示例命令: unity-cli raw find_ui_elements --json '{"namePattern":"Start","includeInactive":true}' unity-cli raw get_ui_element_state --json '{"elementPath":"/Canvas/StartButton"}' unity-cli raw click_ui_element --json '{"elementPath":"/Canvas/StartButton"}' unity-cli raw set_ui_element_value --json '{"elementPath":"/Canvas/NameInput","value":"Player1"}'
典型用法示例:“找到开始按钮并点击它”“读取 /Canvas/NameInput 的当前值再将其设为 Player1”“在当前 UI 中运行一段简短的滑块交互序列”。
参考:runtime-checklist.md 说明连接与实例前置条件;ui-test-flow.md 提供更安全的“定位—检查—交互”UI 测试流程。
限制:资料未提供支持的 Unity 版本、平台范围、安装细节及收费信息,暂未提供。