步骤、脚本和 AutoHotkey
操作要执行的内容可以用三种方式编写。操作 页面 执行内容 卡片上的 编写方式 用于选择运行哪一种。
| 方式 | 是什么 | 何时选择 |
|---|---|---|
| 步骤 | 由您选择并填写的步骤组成的列表,每个步骤一行。无需键入代码。 | 您希望在不编写代码的情况下构建操作。大多数操作都适用:发送按键、键入文本、移动或关闭窗口、等待、提问。 |
| 脚本 | Input.Observer 自己的脚本语言,在代码编辑器中键入。 | 您需要算术运算、用多个部分拼接文本、用变量计数的循环,或任何步骤无法表达的内容。 |
| AutoHotkey | 一个 AutoHotkey v2 脚本,由 AutoHotkey 本身运行。 | 您已经有 AutoHotkey 代码,或者需要只有 AutoHotkey 才能做到的事情。 |
步骤和脚本在 Input.Observer 内部运行,并调用相同的内置函数:步骤是以可视化方式编写脚本所要做的事情。请参阅步骤和脚本语言参考。
每种方式保留自己的内容
一个操作同时保存步骤正文、脚本正文和 AutoHotkey 正文。切换 编写方式 ① 会改变运行哪一个。它永远不会删除其他正文,因此您可以切换回来。
如果您选择的方式为空而另一种方式有内容,开关下方会显示一条通知,说明运行该操作不会执行任何事情,并提供一个按钮来使用有内容的那种方式。
从步骤切换到脚本
当操作有步骤且其脚本正文为空时,从 步骤 切换到 脚本,Input.Observer 会提议转换这些步骤:是否将步骤转换为脚本? 选择 转换 可将转换结果放入脚本编辑器。
- 步骤保持原样。切换回 步骤 会看到它们没有变化。
- 没有反向转换。脚本无法转换为步骤。
- 使用了 当…时重复、重复直到、退出循环 或 停止步骤 的步骤不会提供转换,因为脚本中没有对应的语句。您仍然可以切换;只是脚本正文会从空白开始。
- 永远不会与 AutoHotkey 相互转换。
- 当这些步骤是来自 录制器 页面的录制内容时,对话框还会说明脚本会忽略 回放速度 和 回放鼠标路径细节:其等待按录制时的速度运行,并且会回放每一次录制的鼠标移动(录制器设置)。
从步骤到脚本展示了每种步骤会变成什么。
AutoHotkey
AutoHotkey 是一个独立的程序,Input.Observer 会在运行 AutoHotkey 操作时启动它。它不随附提供;您需要自行安装 AutoHotkey v2,并告诉 Input.Observer 它在哪里。
- 安装 AutoHotkey v2。
- 在 常规 页面上,打开 启用 AutoHotkey,并将 AutoHotkey 可执行文件 设置为其程序文件,例如
AutoHotkey64.exe。 - 现在 AutoHotkey 会出现在 编写方式 下。应用更改,使引擎使用新设置。
规则:
- 只有当 启用 AutoHotkey 打开时,或者操作已经以 AutoHotkey 方式运行时,编写方式 下才会提供 AutoHotkey。在 AutoHotkey 关闭时,AutoHotkey 操作不执行任何事情,页面会加以说明。
- 请使用普通的 AutoHotkey 版本。名称中带有
_UIA的版本(例如AutoHotkey64_UIA.exe)无法运行来自 Input.Observer 的脚本。 - 当 AutoHotkey 已打开,但在启动时或重新加载配置时找不到其程序时,Input.Observer 会请您选择 浏览 AutoHotkey 可执行文件 或 保持现状。
- 每次运行都会用您的脚本启动一个新的 AutoHotkey 进程。它无法调用 Input.Observer 的内置函数。打开 等待其完成 时,操作会一直运行到脚本自行结束,停止所有操作热键可以结束它(持续运行的脚本)。
- 在您的脚本之前,Input.Observer 会设置描述触发器的变量,例如
IO_ActionName、IO_TriggerKind以及手势或热键的窗口(AutoHotkey 变量)。编辑器的 此处可用的变量 列表会显示该操作的触发器提供的变量;单击某个变量即可插入它。 - 脚本写入其标准输出的内容会以
AHK:开头显示在诊断控制台中(诊断控制台)。
步骤或脚本操作也可以使用 AutoHotkeyExecuteScript 内置函数运行一段 AutoHotkey 代码并等待其完成,或使用 AutoHotkeyStartScript 启动一段代码而不等待。适用相同的设置和可执行文件。
持续运行的脚本
带有热键、热字串或计时器的 AutoHotkey 脚本在执行完最后一行后仍会继续运行。要从 Input.Observer 启动这样的脚本,请在 AutoHotkey 编辑器下方关闭 等待其完成。凡是有 AutoHotkey 内容的地方都有这个开关:操作、每个操作之前 和 每个操作之后 脚本、全局事件以及代码片段。
| 等待其完成 打开 | 等待其完成 关闭 | |
|---|---|---|
| 操作 | 一直运行到脚本结束 | AutoHotkey 一启动即完成 |
| 脚本写入的内容 | 以 AHK: 开头显示在诊断控制台中 | 不显示 |
| 语法错误 | 显示在诊断控制台中 | AutoHotkey 显示自己的错误框 |
| 停止所有操作热键 | 结束脚本 | 让它继续运行 |
| 保存设置或 重新加载配置 | 与其他正在运行的操作一起结束脚本 | 让它继续运行,除非它是由 配置已加载 事件启动的 |
| Input.Observer 退出 | 结束脚本 | 结束脚本 |
由 配置已加载 启动的脚本会在保存或重新加载设置时结束,因为该事件随后会再次运行并启动一个新副本。否则,每次保存都会多留下一个正在运行的副本。要在整个会话中保持一个脚本副本运行,请将它放在 配置已加载 中,并关闭 等待其完成。
AutoHotkeyStartScript 的行为与关闭该开关时相同,并返回它所启动的 AutoHotkey 的进程 ID。
AutoHotkey 变量
每次 AutoHotkey 运行都以 Input.Observer 在您的脚本之前添加的几行开始,这几行会根据触发操作的内容设置 IO_ 变量。这适用于以 AutoHotkey 编写的操作,也适用于用 AutoHotkeyExecuteScript 或 AutoHotkeyStartScript 运行的代码,后者会获得调用它的操作的变量。
每次运行 都会设置这三个:
| 变量 | 内容 |
|---|---|
IO_ActionName | 操作的名称。对于全局事件,是 Global_Event_ 后跟配置文件中该事件的名称,例如 Global_Event_release 或 Global_Event_foreground_changed。当没有任何内容触发该运行时(例如从控制台运行的脚本)为空。 |
IO_AppGroupName | 找到该操作的应用程序组的名称,例如 Global。对于全局事件为空。 |
IO_TriggerKind | 触发运行的内容:Gesture、Hotkey、TextExpansion、MouseButton(按钮组合触发器,或者鼠标按键或 绘制按钮已释放 全局事件)、Wheel(滚轮触发器或滚轮全局事件)或 None。 |
其余变量取决于触发器,只会设置该触发器的变量:
| 触发器 | 变量 | 内容 |
|---|---|---|
| 手势 | IO_GestureWindow | 手势开始时所在的窗口 |
IO_GestureButton | 绘制按钮:left、right、middle、x1 或 x2;绘制键则为 key | |
IO_GestureStartX、IO_GestureStartY | 笔划开始的位置 | |
IO_GestureEndX、IO_GestureEndY | 笔划结束的位置 | |
IO_GestureBoundsLeft、IO_GestureBoundsTop、IO_GestureBoundsRight、IO_GestureBoundsBottom | 包围整个笔划的矩形 | |
IO_GesturePoints | 按绘制顺序排列的笔划的每个点,形式为由 [x, y] 数组组成的数组 | |
| 热键 | IO_HotkeyWindow | 按下热键时的前台窗口 |
IO_HotkeyVkCode | 最后一个键的 Windows 虚拟键码,例如 K 为 75 | |
IO_HotkeyModifiers | 组合键中的修饰键之和:Ctrl 1、Shift 2、Alt 4、Win 8(Ctrl+Alt 为 5) | |
| 文本扩展 | IO_TextExpansionWindow | 您键入时所在的窗口 |
IO_TextExpansionPattern | 您键入的缩写 | |
| 鼠标按键事件 | IO_MouseWindow | 指针下方的窗口 |
IO_MouseButton | 按键:left、right、middle、x1 或 x2;对于用绘制键绘制手势后的 绘制按钮已释放,为 key | |
IO_MouseX、IO_MouseY | 指针所在的位置 | |
| 滚轮触发器或滚轮事件 | IO_WheelWindow | 对于滚轮触发器,为您按下绘制按钮时所在的窗口;对于滚轮事件,为指针下方的窗口 |
IO_WheelDelta | 滚轮转动的幅度,与 Windows 报告的相同:普通滚轮的一格为 120(平滑滚动的滚轮和触摸板发送的步长更小),远离您(或向右)为正,朝向您(或向左)为负。滚轮触发器总是得到 120 或 -120 | |
IO_WheelHorizontal | 横向滚轮转动为 true,普通滚动为 false | |
IO_WheelX、IO_WheelY | 指针所在的位置 | |
IO_WheelButton | 对于滚轮触发器,为您按住的绘制按钮:left、right、middle、x1 或 x2,绘制键则为 key。对于滚轮事件为空 |
- 窗口 是窗口句柄,即 AutoHotkey 读作窗口 ID 的数字:
"ahk_id " IO_GestureWindow可在WinActivate、WinGetTitle和其他窗口函数中指定该窗口。 - 位置 是以物理像素为单位的屏幕坐标,从主显示器的左上角算起。在将它们用于 AutoHotkey 的鼠标函数之前,请先设置
CoordMode "Mouse", "Screen",否则这些函数是相对于活动窗口工作的。 - 文本 会原样传递;操作名称或组名称中的引号、反引号和换行符会自动转义。
- 触发器未提供的变量根本不会被设置,而 AutoHotkey 在读取未设置的变量时会停止脚本。有多种触发器的操作,或从不同操作调用的代码片段,应先检查
IO_TriggerKind,或使用IsSet(IO_GestureWindow)。
例如,一个由手势或热键运行的操作,将使用它的窗口置于前台并显示其标题:
CoordMode "Mouse", "Screen"
win := IO_TriggerKind = "Gesture" ? IO_GestureWindow : IO_HotkeyWindow
WinActivate "ahk_id " win
MsgBox WinGetTitle("ahk_id " win), IO_ActionName
插件脚本引擎
插件可以添加自己的脚本引擎。这时它会以插件的名称出现在 编写方式 下,您在那里键入的文本会原样传给插件;Input.Observer 不会检查它。请参阅插件。
- 没有已注册的插件提供该引擎(例如插件已被移除):编写方式 会将该引擎标为未注册,其下方的警告说明此脚本在运行时会被跳过。此时操作不执行任何内容,也没有消息提示。
- 插件已注册,但无法接受这次运行(例如插件已禁用、已停止或正在重新启动):操作不会运行,之后也不会重试。控制台的 系统 部分会写入一行,指明插件和引擎(控制台),同时一条 Windows 通知会指明操作和插件。只有在 Windows 通知 打开时才会显示该通知(常规设置)。
在简单模式下
简单模式只为已经有脚本或 AutoHotkey 正文的操作显示 编写方式。对于其他任何操作,卡片会直接显示步骤。要将新操作编写为脚本,请将窗口切换到高级模式(配置窗口)。