跳转至

录制目标与素材

宏录制会从当前时间指示器开始，把输入动作写入 PC 或 ADB 轨道，并可同时生成截图或视频素材。录制不是独立文件：停止后得到的片段、组件关系和媒体资源都属于当前宏与根蓝图。

宏编辑器没有暂停或继续录制。一次录制只有“开始”和“结束”；需要追加内容时，把时间指示器移到新起点，再开始下一次录制。

录制设置何时出现

时间线工具条提供“录制”和“录制设置”两个相关入口：

  • 主动打开“录制设置”并确认，只更新本次编辑会话的设置，不会立即录制。
  • 点击“录制”时，如果设置完整且目标仍然有效，会直接进入录制准备。
  • 首次录制、目标未配置、范围不完整或原目标已经消失时，编辑器会自动打开设置窗口；此时确认按钮为“保存并开始录制”。
  • 每次开始前都会复核原目标，不会在屏幕、范围或 ADB 设备变化后悄悄换到另一个目标。

录制目标与录制偏好只属于“本次打开蓝图”的临时会话，并与需要目标的 Debug 共用。它们不写入蓝图、撤销历史或 .gmacro；离开并重新打开蓝图后需要重新指定。

三种录制模式

录制设置只有 ADB、范围和屏幕三种模式，不包含“窗口录制”。

模式 需要指定 适合用途 失效条件
ADB 一个可用 Android 目标，以及它在 Windows 桌面上的内容区矩形 同时记录组件映射与自由触摸 目标断开、更换目标，或矩形未设置
范围 桌面上的任意矩形 只录制一个应用内容区或自定义区域 显示器布局变化，或范围不再落在活动显示器内
屏幕 一个显示器 录制整块显示器 该显示器消失或身份变化

范围模式可手动框选，也可利用捕捉功能选择窗口内容区。保存的是绝对桌面坐标，不会跟着窗口移动；开始录制前应确认目标窗口没有被移动或缩放。

ADB 为什么仍要框选 Windows 范围

ADB 地址只能确定 Android 目标，不能确定它当前显示在桌面的哪一块。选择 ADB 目标后，还必须点击“框选范围”选择对应的 Windows 内容区。

这个矩形用于：

  1. 把物理鼠标位置换算成 Android 坐标。
  2. 开启视频时，确定 Windows 录屏区域。
  3. 在非录制状态下，把组件和 ADB 触点投射到实际内容区，辅助校对。

ADB 截图是例外：它直接从所选 Android 目标取得 PNG，不截取这个 Windows 矩形。

未框选时，“保存设置”不可完成。点击它会让“框选范围”按钮红色闪烁约 1 秒；更换 ADB 目标会清除旧范围，避免把上一台设备的桌面矩形错用到新目标。

截图、视频和声音

截图与视频是两个独立选项，可以只开其中一个、同时开启，或全部关闭。

选项 默认值 行为
录制截图 开启 按绑定键生成无损 PNG 和图像片段
截图绑定 鼠标左键 可改为一个键或键盘/鼠标组合
录制视频 关闭 生成一个连续 MP4 资源和一个视频片段
录制帧率 30 fps 开启视频后可设为 1–120 fps
录制声音 关闭 仅写入 MP4，宏时间线不播放声音

当前没有用户可调的录屏码率选项，编码质量由录制后端管理。系统不支持声音回环时，不能开始带声音的录屏。

软件设置中的“截图与录屏 HDR 模式”默认关闭。一次录制会固定使用开始时的 HDR 设置，录制中途修改不会改变本次捕捉管线。ADB 直出截图不经过桌面 HDR 管线。

截图绑定

点击截图绑定可录入键盘键、鼠标左/中/右键或组合。所有成员按下时触发一次截图；必须先释放组合中的成员，下一次完整按下才会再次触发。系统重复键事件不会造成连续重复截图。

截图触发不受“仅录制映射按键”过滤。如果把 F8 设为截图键，录制窗口会提示使用“结束”按钮停止，以免同一次按键同时截图和结束录制。

仅录制映射按键

屏幕和范围模式可选择“仅录制映射按键”。开启后，未绑定到组件的键盘输入会被忽略；鼠标录制不受影响。

ADB 模式会强制开启该选项，因为普通键盘动作需要组件提供 Android 坐标或路径。映射键与非左鼠标键会同时保留 PC 动作，并按组件生成 ADB 触摸。

物理鼠标左键是 ADB 录制中的唯一特殊输入：

  • 它可以越过“仅录制映射按键”规则。
  • 按下、移动和抬起会直接生成自由 ADB 触摸。
  • 它不会同时生成 PC 鼠标路径，也不会再通过映射重复触发一次。
  • 只有一个坐标时，仍由 DOWN 到 UP 的持续时间表达原地按压，不使用点击/长按阈值。

开始与结束

录制从当前时间指示器开始，进入固定 3 秒倒计时。准备、倒计时和正式录制期间，编辑器会锁定时间线、组件、节点和资源写入，避免录制快照与手工修改相互覆盖。

录制进行时：

  • 时间指示器持续向后移动。
  • 时间线以临时 UI 显示鼠标路径、按键和 ADB 触摸，便于确认正在记录。
  • 鼠标路径在一次录制中保持连续，不因鼠标左键按下或抬起而分段。
  • 正式截图和视频资源在结束后统一写入。
  • ADB 外部编辑叠层会先完全隐藏，防止范围边框、组件或触点进入素材；结束后再恢复。

停止时，录制结果会转换并作为一次历史操作写入。普通 PC 输入保留真实按下与抬起时长；ADB 映射动作则按组件定义生成坐标、路径和持续时间。

素材写入哪条轨道

截图会成为无损 PNG 图像片段，默认持续 5 秒。如果下一张截图在 5 秒内出现，上一张会提前结束到下一张起点。

视频始终是一个连续 MP4 片段，不会拆成每秒几十张图片：

开启组合 预览轨结果
仅截图 截图进入主预览轨
仅视频 视频进入主预览轨
截图和视频 截图进入最上方主轨，视频进入下一条预览轨
两者都关闭 只写入操作片段

所有结果都以录制起点为时间偏移。结束后，时间指示器移动到本次最长结果的末端，并选中新片段。

与旧内容重叠时，同一预览轨的图像、视频和鼠标路径会按录制覆盖区间切开或替换；PC 与 ADB 动作会追加到可用轨道。被替换片段不再引用的媒体可能变成未使用资源，并按蓝图的资源清理规则处理。

ADB 并发与触点预算

一个解析后的组件动作占用一个 Android 触点。当前实时录制最多管理 5 个触点；自由鼠标左键活动时会为它预留一个位置。

超过预算时，新按下会被拒绝，但抬起事件仍会保留，以避免已经存在的触点卡住。轨道数本身不是硬性 3 条限制；添加到第 4 条及以后时，编辑器会提醒确认目标设备能够承受对应并发触点。

失败如何处理

以下问题会在开始前阻止录制：目标或范围失效、捕捉能力不可用、声音回环不可用、映射组件冲突或静态解析失败。

如果录制期间的辅助会话、ADB 实时映射、停止转换或资源写入失败，整次录制会回退到开始前快照，不留下半成品片段。单张截图失败属于可恢复错误：该图片会被跳过，其余操作和素材仍可提交，完成通知会报告失败数量。

录制前检查

  1. 把时间指示器放到希望写入的起点。
  2. 确认录制模式和目标仍然有效。
  3. ADB 模式确认设备、Windows 内容区和画布分辨率相互对应。
  4. 确认截图、视频、声音和帧率组合。
  5. 检查映射冲突及并发触点数量。
  6. 开始录制，倒计时结束后再操作目标。
  7. 点击“结束”，等待资源写入完成后再编辑或保存。

继续阅读