宏编辑器¶
宏编辑器用于编辑“在什么时间发生什么操作”。它把桌面输入、ADB 触摸、图像和视频组织成轨道与片段,并把组件、绑定关系和实际引用的资源保存在宏节点中。
录制只是生成片段的一种方式。录制结束后,仍可选择、移动、裁切、复制、转换和重新绑定片段;也可以完全不录制,直接在时间线上建立内容。
打开宏编辑器¶
在蓝图画布中双击宏节点即可进入。宏编辑器仍属于当前蓝图,不是另一份独立文件。
进入时,编辑器会读取宏节点内部的时间线、组件和内部节点数据。点击左上“返回”会把当前编辑结果写回外层宏节点并回到蓝图画布,但这一步不等于把蓝图保存到磁盘;要持久化修改,仍需点击左上“保存”。也可以不退出宏编辑器,直接保存整份蓝图。
录制准备或录制进行中,编辑器会暂时禁止返回和保存,以免录制快照与正在修改的数据相互覆盖。
界面结构¶
| 区域 | 用途 |
|---|---|
| 左侧片段属性 | 编辑当前片段;多选时显示可共同修改的属性。 |
| 中央预览区 | 查看当前时间的图像或视频、组件、鼠标位置、按键提示和 ADB 触点。 |
| 右侧组件属性 | 编辑预览区中选中的轮盘、拖拽、按键映射、屏幕位置等组件。 |
| 底部时间线 | 按时间排列预览、桌面和 ADB 轨道及其片段。 |
| 时间线左上工具条 | 录制或结束录制,以及导入、导出和打开录制设置。 |
| 顶部全局工具栏 | 返回、保存、打开内嵌管理,以及配置和运行 Debug。 |
左侧片段属性和右侧组件属性相互独立:选中片段不会挤掉组件属性,选中组件也不会取消时间线片段选择。
窗口变宽或最大化时,中央预览区会获得主要的新增空间;左右属性栏宽度和时间线高度保持相对稳定。三个分隔条均可拖动,录制写入期间则会锁定。
时间线中的对象¶
| 区段 | 轨道 | 主要内容 |
|---|---|---|
| 预览 | 一条主预览轨和可增加的图像/视频轨 | 图像片段、视频片段。 |
| 桌面 | 固定鼠标路径轨和可增加的桌面动作轨 | 鼠标路径、按键、桌面输入、图像识别、跳转和退出。 |
| ADB | 一条基础 ADB 轨和可增加的 ADB 轨 | 触摸、ADB 输入、跳转和退出。 |
跳转和退出是动作轨中的控制片段,不是独立轨道。嵌套片段则把一组片段封装为可双击进入的子时间线。
时间线内部以毫秒为时间精度,界面按秒或分钟显示。这里的“毫秒时间基”不等于录屏帧率,也不等于视频片段帧率;三者是彼此独立的概念。
推荐工作流¶
- 先设置画布分辨率,并把时间指示器移动到准备编辑的位置。
- 在轨道空白处右键添加所需片段,或通过录制生成片段。
- 在左侧属性中校对按键、坐标、路径、资源和持续时间。
- 在预览区放置组件,并根据需要把片段按键或坐标绑定到组件。
- 用时间指示器擦洗各时刻,检查图像层级和操作可视化。
- 通过右上 Debug 检查真实执行,再保存蓝图。
本章内容¶
- 工作区与预览画布:区域尺寸、画布分辨率、缩放平移、素材显示和多预览轨优先级。
- 轨道与片段:轨道结构、片段类型、新增删除、重叠、覆盖和嵌套。
- 选择、编辑与快捷键:框选、时间导航、移动、裁切、切割、剪贴板和默认键位。
- Debug 与操作可视化:动态预览入口、轨道显隐、按键气泡、鼠标路径、ADB 触点和外部范围叠层。
- 录制目标与素材:三种录制模式、临时目标、截图与视频、ADB 自由触摸和失败回退。
- 组件、映射与绑定:轮盘、拖拽、屏幕位置、按键来源、坐标锚点和 F7 实时映射。
- 转换、循环与控制:PC/ADB 双向转换、嵌套、跳转、退出和条件循环。
- 导入与导出 .gmacro:可裁减宏包、真实资源闭包、整体替换和画布批量导入。
保存与恢复原则¶
- 宏内修改与蓝图节点修改共用撤销和重做历史。
- 返回外层只是更新当前编辑会话中的宏节点,不是磁盘保存。
- 保存会同时校验宏路径、图像识别目标和待写入资源;校验失败时会定位问题片段并阻止保存。
- 预览区的缩放和平移属于编辑视图状态,不会随
.gmacro永久保存。 - 轨道显隐、组件、片段和画布分辨率属于宏数据,会随宏保存。