Перейти к основному содержимому

Как выполняются скрипты

  • Один поток на запуск. Каждый сработавший скрипт выполняется в собственном потоке, со своими переменными и кэшами перечислений. Два жеста, выполненные почти одновременно, работают параллельно. Именованная блокировка не даёт им перемешивать общую работу. Исключение — монитор COM-порта: его строки обрабатываются по одной, в порядке поступления. Параметр Максимум одновременных действий ограничивает, сколько их выполняется одновременно; при его достижении происходит то же, что и по горячей клавише остановки всех действий (Параметры скриптов).
  • Скрипт может блокироваться. UtilityWait, окна сообщений, ShellRunProgram с ожиданием завершения и чтение из COM-порта блокируют поток своего скрипта и больше ничего. Ввод с мыши и клавиатуры продолжает поступать.
  • Остановка. EngineStopAllActions() и кнопка Остановить все в консоли завершают каждый выполняющийся скрипт на его следующей инструкции, поэтому бесконечный цикл всегда можно остановить. Встроенные функции, которые ждут, замечают запрос на остановку во время ожидания: UtilityWait, ожидание блокировки и данных COM-порта, WindowWaitFor, WindowWaitClose, ClipboardCopySelection, KeyboardTypeText (останавливается перед следующим символом), MacroPlayTemporary, SnippetExecuteScript, AutoHotkeyExecuteScript (завершает процесс AutoHotkey), ShellRunProgram с ожиданием завершения (оставляет программу работать), ShellShowToast, MultimediaPlayMp3File и UIShowConsole. Остальные встроенные функции, включая окна сообщений, сначала завершают текущий вызов. Горячая клавиша остановки всех действий делает то же самое, а также удаляет все таймеры, отслеживания папок и мониторы COM-портов и отключает жесты, горячие клавиши и подстановку текста до Перезагрузить конфигурацию (Горячая клавиша остановки всех действий).
  • Что сохраняется между запусками:
    • StorageSetValue/StorageGetValue: именованные значения любого типа, общие для всех скриптов, хранятся в памяти, пока работает движок. StorageGetValue для имени, которое никогда не задавалось, возвращает Integer 0. Хранится до 1 024 значений с именами до 256 символов и Text до 32 768 символов; превышение предела останавливает действие с ошибкой.
    • StorageSetPersistentValue/StorageGetPersistentValue: то же самое с теми же пределами, но значения хранятся в storage.toml рядом с файлом конфигурации и сохраняются после перезапуска. Window сохранить нельзя (пример).
    • Свойства окна (WindowSetPropertyInteger/…Text): значения, привязанные к одному окну и исчезающие при его закрытии или при завершении работы Input.Observer. Текстовое значение — не более 1 024 символов, одновременно можно хранить до 512 текстовых значений.
    • Именованные таймеры, отслеживание папок и мониторы COM-портов, которые движок продолжает выполнять после завершения создавшего их скрипта, пока их не удалят или не нажмут горячую клавишу остановки всех действий. Перезагрузка или сохранение конфигурации их не завершает; скрипт события Конфигурация загружена, который снова создаёт такой объект с тем же именем, заменяет его.
  • Скрипты, переданные как Text. TimerCreate, FolderWatchCreate и SerialMonitorCreate принимают скрипт в виде аргумента Text. Он компилируется и запускается отдельно при каждом срабатывании, поэтому у него свежие переменные и он не видит переменных создавшего его скрипта. Кавычки внутри него требуют экранирования \"; либо держите скрипт во фрагменте и передавайте SnippetGetScript("name").
  • Контекст. Встроенные функции Context* описывают то, что запустило текущее выполнение: жест, его точки и ограничивающий прямоугольник, окно и элемент управления под ним, кнопку, событие отслеживания или строку с COM-порта. У скрипта таймера нет контекста триггера. Скрипт отслеживания папки получает значения ContextGetWatch*, а скрипт монитора COM-порта — значения ContextGetSerial*. Скрипт события колеса получает ContextGetWheelDelta и ContextGetWheelHorizontal, а скрипт события кнопки мыши или колеса получает позицию указателя из ContextGetEventX и ContextGetEventY.
  • Фрагменты — именованные скрипты в конфигурации. SnippetExecuteScript выполняет фрагмент до конца, прежде чем вызывающий скрипт продолжит работу, и возвращает true, только если фрагмент выполнен до конца. Фрагмент разделяет контекст триггера вызывающего скрипта, но имеет собственные переменные.
  • Безопасный режим блокирует все скрипты, кроме запущенных из диагностической консоли.