蓝图编辑器¶
蓝图编辑器用于编辑单个蓝图。蓝图以节点表达取值、判断和动作，以连线表达执行顺序和数据传递，并把变量、节点组和实际引用的资源一起保存。
宏节点中的连续操作使用独立时间线编辑器。时间轴、片段、轨道、录制和预览组件请阅读宏编辑器，不要把它们与普通节点画布混为一体。
界面组成¶
| 区域 | 作用 |
|---|---|
| 中央节点画布 | 编辑节点、连线、普通框、注释框和图片框。 |
| 左侧变量条 | 在蓝图已有变量时出现，用于选择、重命名、排序和插入变量访问节点。 |
| 左上操作栏 | 返回、保存、保存默认布局、内嵌管理和栅格吸附。 |
| 右上操作栏 | 修改文件名，以及开始或停止 Debug；需要目标的局部编辑界面会额外显示目标入口。 |
| 按需面板 | 在需要时显示内嵌资源、节点组接口或节点专用编辑器；不是常驻的通用属性栏。 |
画布空白处右键还可以打开图像帧数轴。该数轴显示在底部，主要服务需要按时间取图的节点；它不是宏节点的多轨时间线。
推荐工作流¶
- 在画布中按
Shift+A添加节点。 - 从输出端口拖到兼容输入端口，建立执行线或数据线。
- 为需要复用或对外配置的值建立变量，并明确开始、结束节点的蓝图接口。
- 使用框、注释和节点组整理复杂逻辑。
- 检查内嵌资源与目标，再通过右上播放按钮 Debug。
- 点击左上“保存”写入蓝图；仅保存默认布局不能代替保存当前蓝图。
本章内容¶
- 画布、选择与快捷键：移动视图、框选、放置节点、调整宽度和默认快捷键。
- 节点、端口与连线：执行线、数据线、自动接线、切线、转接点和屏蔽。
- 变量与蓝图接口：变量访问、开始与结束节点、动态接口和类型提示。
- 节点组、画布标注与剪贴板：可复用节点组、说明对象、跨蓝图复制及依赖迁移。
- Debug、保存与内嵌资源：四种 Debug 目标、临时目标生命周期、保存限制和资源管理。
具体节点的端口、属性和失败条件见节点参考。
三类容易混淆的对象¶
| 对象 | 解决的问题 | 是否改变执行逻辑 |
|---|---|---|
| 普通框、注释框、图片框 | 整理画布并说明设计意图。 | 否 |
| 节点组 | 把多个节点封装成具有明确输入输出的可复用节点。 | 是 |
| 宏节点 | 按时间组织 PC、ADB、图像和视频等连续操作。 | 是 |
保存与运行原则¶
- 右上播放按钮执行的是 Debug；它会先尝试静默保存，保存失败时不会继续。
- 需要外部目标的局部 Debug 可选择屏幕、窗口、范围或 ADB；宏录制只有屏幕、范围和 ADB 三种模式。
- 同一蓝图编辑会话中的录制、实时映射和需要目标的 Debug 共用一份临时目标。离开或切换蓝图后，该目标会被清空。
- 返回时，编辑器会对节点内容、连接、变量、节点组、画布标注和资源等修改给出保存确认。仅调整节点位置、宽度、视图或顶部文件名后，请主动点击保存。
- 录制准备或录制进行中，保存、退出和部分编辑操作会暂时不可用。