跳转至

Debug 与操作可视化

宏编辑器会根据时间指示器显示当前画面和操作状态。手动拖动时间指示器适合逐点检查;需要连续运行和真实目标反馈时,使用右上 Debug。

当前没有独立预览播放按钮

底部左上工具条只有录制、结束录制、导入、导出和录制设置,不提供普通播放、暂停或继续按钮。空格键也不是本地预览播放键。

动态查看有两种方式:

  1. 在顶部标尺单击或拖动时间指示器,手动擦洗画面和操作状态。
  2. 使用右上 Debug,让执行状态驱动时间指示器并自动滚动时间线。

如果 Debug 因目标缺失而暂停,编辑器会定位失败片段。目标恢复后,按界面提示使用空格键继续;这个空格行为只属于“目标缺失后继续 Debug”,不是通用播放开关。

轨道小眼睛

每条预览轨、桌面轨和 ADB 轨都有自己的显隐状态。

  • 预览轨小眼睛:决定该轨图像或视频是否参与当前预览。
  • 桌面轨小眼睛:决定鼠标、路径和按键提示是否显示。
  • ADB 轨小眼睛:决定该轨触点是否显示。
  • PC 和 ADB 总开关:分别门控整个区段的操作可视化。

关闭 PC 或 ADB 总开关不会改写子轨道自己的小眼睛。重新开启总开关后,原先“某些轨显示、某些轨隐藏”的组合会恢复。

所有小眼睛都只控制预览可视化,不删除片段,也不影响执行。显隐状态会随宏和 .gmacro 保存。

主预览轨是一个例外:隐藏它会让预览区改用下方可见轨道,但自动生成图像模板仍固定读取主轨。

PC 按键气泡

桌面动作会在画布内部右下角显示按键气泡:

  • 最新动作从底部出现,并把旧气泡向上顶。
  • 最多显示 8 个。
  • 按键保持按下时,气泡持续存在。
  • 松开后保留约 2 秒,再用约 300 毫秒渐隐。
  • 气泡尺寸跟随画布显示尺寸等比变化,不会因为源素材是 4K 就突然显示得更大。

气泡可以表示普通键、组合或顺序键、双击次数、滚轮方向、桌面输入文本和控制动作。桌面输入气泡会直接显示片段当前生效的文字;如果片段绑定了字符串变量,显示的是该变量当前提供的值。录制演示或分享画面前,应隐藏包含账号、密码或其他敏感文字的桌面动作轨。

顺向运行经过动作时会依次产生气泡。直接把时间指示器向后拖,不会把途经的所有历史气泡重新播放一遍;编辑器只重建目标时刻仍保持按下的按键。

鼠标路径与当前位置

预览区会根据时间指示器在共享鼠标路径中插值,显示当前鼠标位置。

  • 只有当前选中的路径型片段会绘制完整路径和可编辑采样点。
  • 未选中的所有路径不会同时铺满画布。
  • 对应轨道或 PC 总开关隐藏后,鼠标位置和路径都会消失。
  • Debug 或录制进入需要隐藏编辑叠层的阶段时,相关可视化也会暂时关闭。

路径采样时间不必与片段边界完全相等;编辑器会在相邻采样之间插值,以显示当前时刻的位置。

ADB 触点

ADB 触摸片段以圆形触点显示:

  • 不同 ADB 轨使用 5 种固定颜色循环区分。
  • 触点会根据当前时间显示按下位置和移动过程。
  • 暂停或手动擦洗时,也会重建目标时刻应存在的触点。
  • 同一坐标上的多个触点不会合并,而是以同心圆区分。
  • 触点大小随画布显示高度等比缩放。

Debug 运行时,如果执行层已经确认了实时触点位置,预览会优先显示真实执行反馈;否则按时间线片段重建预期位置。小眼睛只影响显示,不会让触摸停止执行。

预览组件

预览区可放置四向轮盘、八向轮盘、ADB 拖拽、ADB 四向拖拽、按键映射、屏幕位置和条件循环区域等组件。

  • 组件位置使用画布坐标,画布缩放和平移时会跟随画面。
  • 按键标签使用固定屏幕像素尺寸,避免缩小画布后无法看清。
  • 双击可编辑的映射点会进入内联按键捕获,并显示“请输入按键”。
  • 鼠标左键用于画布交互,不能作为这种双击捕获的映射键。
  • 轮盘边缘拖动用于调整半径,内部拖动用于移动位置;轮盘中心没有映射键。

片段属性与组件属性相互独立。选中组件后可在右侧修改;选中片段后仍可在左侧查看它绑定到哪个组件或组件锚点。

ADB 编辑范围叠层

当当前宏的录制设置为 ADB、已经选定目标和有效矩形范围时,外部范围可显示一层鼠标可穿透的编辑叠层。它把预览中的可投射组件和 ADB 触点映射到实际范围,帮助核对坐标和窗口尺寸。

叠层只在宏编辑器打开且未处于框选、录制准备或正式录制时显示:

  • 在预览区移动组件后,外部叠层会同步更新。
  • 录制开始前会等待叠层完全隐藏,避免范围框、组件或触点进入截图和视频。
  • 录制结束后,只要目标和范围仍有效,叠层会恢复。
  • 退出宏编辑器会结束当前宏拥有的叠层任务。
  • 条件循环区域只用于编辑逻辑,不投射到外部目标范围。

如果无法确定目标的 Android 执行分辨率,外部叠层只显示范围边框,不显示组件,以免把桌面像素错误当成 Android 坐标。

预览性能原则

宏编辑器不是视频剪辑器。为了让时间指示器移动和 Debug 反馈保持流畅,预览采用以下规则:

  • 同一时间只显示最高优先级的一条视觉素材。
  • 不做多轨透明度合成。
  • 图片预览忽略透明通道,但不改写原始内嵌资源。
  • 视频只解码当前需要的临时预览帧,不生成大量图像片段。
  • 隐藏轨道会停止构建该轨的预览可视化,但不会改变执行数据。

F7 与 Debug 的区别

F7 控制的是 ADB 实时映射注入:第一次按下暂停实时注入,再次按下恢复。输入处理连接可以保持常驻,因此恢复时不需要重新进入宏编辑器。

它不会暂停 Debug 时间线,也不会暂停录制。正式运行、Debug、录制和实时映射是不同状态,请以预览区状态提示和右上运行状态为准。

继续阅读