跳到主要内容

脚本的运行方式

  • 每次分派一个线程。每个被触发的脚本都在自己的线程上运行,拥有自己的变量和枚举缓存。两个相继很快触发的手势会同时运行。命名锁可以防止它们交错执行共享的工作。串口监视器是例外:它的各行按到达顺序逐一运行。同时运行的数量受最大同时运行操作数设置限制;达到该上限时,效果与停止所有操作热键相同(脚本设置)。
  • 脚本可以阻塞。UtilityWait、消息框、等待程序退出的 ShellRunProgram 以及串口读取,都只会阻塞其所在脚本的线程,不影响其他任何内容。鼠标和键盘输入照常传递。
  • 停止。EngineStopAllActions() 和控制台的全部停止会让每个正在运行的脚本在下一条指令处结束,因此死循环总是可以被停止。会等待的内置函数在等待期间也会察觉停止请求:UtilityWait、锁和串口等待、WindowWaitFor、WindowWaitClose、ClipboardCopySelection、KeyboardTypeText(在下一个字符之前停止)、MacroPlayTemporary、SnippetExecuteScript、AutoHotkeyExecuteScript(会结束 AutoHotkey 进程)、等待程序退出的 ShellRunProgram(程序会继续运行)、ShellShowToast、MultimediaPlayMp3File 和 UIShowConsole。其他内置函数(包括消息框)会先完成当前调用。停止所有操作热键的效果相同,此外还会删除所有计时器、文件夹监视和串口监视器,并在重新加载配置之前关闭手势、热键和文本扩展(全部停止热键)。
  • 运行之间保留的内容:
    • StorageSetValue/StorageGetValue:任意类型的命名值,由所有脚本共享,只要引擎在运行就一直保存在内存中。对从未设置过的名称调用 StorageGetValue 会返回 Integer 0。最多可保存 1,024 个值,名称最多 256 个字符,Text 最多 32,768 个字符;超出限制会使操作因错误而停止。
    • StorageSetPersistentValue/StorageGetPersistentValue:与上面相同,限制也相同,但保存在配置文件旁边的 storage.toml 中,因此重新启动后值仍然存在。Window 无法保存(示例)。
    • 窗口属性(WindowSetPropertyInteger/…Text):附加到某个窗口上的值,该窗口关闭或 Input.Observer 退出时随之消失。一个文本值最多 1,024 个字符,同时最多可存储 512 个文本值。
    • 命名计时器、文件夹监视和串口监视器:创建它们的脚本结束后,引擎会继续运行它们,直到它们被删除或按下停止所有操作热键。重新加载或保存配置不会结束它们;配置已加载 脚本以相同名称再次创建时,会替换原有的那个。
  • 以 Text 形式传递的脚本。TimerCreate、FolderWatchCreate 和 SerialMonitorCreate 以 Text 参数的形式接收一段脚本。每次触发时,这段脚本都会单独编译并分派,因此它拥有全新的变量,看不到创建它的脚本中的变量。其中的引号需要用 \" 转义,或者将脚本保存在代码片段中并传入 SnippetGetScript("name")。
  • 上下文。Context* 内置函数描述触发本次运行的内容:手势、其点和边界框、其下方的窗口和控件、按钮、监视事件或串口行。计时器的脚本没有触发上下文。文件夹监视的脚本可获取 ContextGetWatch* 的值,串口监视器的脚本可获取 ContextGetSerial* 的值。滚轮事件的脚本可获取 ContextGetWheelDelta 和 ContextGetWheelHorizontal,鼠标按钮事件或滚轮事件的脚本可通过 ContextGetEventX 和 ContextGetEventY 获取指针所在的位置。
  • 代码片段是配置中的命名脚本。SnippetExecuteScript 会将其运行完毕,然后调用方才继续;只有代码片段运行到结尾时才返回 true。它与调用方共享触发上下文,但拥有自己的变量。
  • 安全模式会阻止所有脚本运行,从诊断控制台运行的脚本除外。