Automation Runtime
Automation Runtime исполняет отдельно подготовленный GUI-сценарий на основе проекта Screph. Он ищет визуальные или текстовые состояния, ждёт условия и отправляет команды выбранному способу ввода.
Что нужно для запуска
- Сохранённый проект GUI Automation с нужными элементами и визуальными признаками.
- Отдельный сценарий Python, который явно открывает проект и задаёт последовательность действий.
- Подготовленные зависимости для сценария, поиска изображений и при необходимости OCR.
- Проверенный способ ввода: Arduino HID или FakerInput Virtual HID.
Проверка перед исполнением
Перед запуском Screph проверяет, что проект читается и содержит необходимые данные. Это не гарантирует, что нужное окно открыто, имеет правильный масштаб и тему или находится на ожидаемом мониторе. Эти условия должен проверять сценарий непосредственно перед действием.
Поиск целей
| Способ | Когда подходит |
|---|---|
| Сопоставление изображения | Для устойчивого визуального шаблона при известном масштабе и состоянии интерфейса. |
| OCR | Для текста, который может менять положение, но остаётся читаемым. |
| Координаты и область | Для ограниченного поиска в известной части выбранного монитора или окна. |
Шаблоны зависят от масштаба, темы, состояния окна и качества исходного изображения. После поиска сценарий должен проверить ожидаемое состояние до отправки ввода.
Способы ввода
- FakerInput Virtual HID использует системный драйвер, который устанавливается отдельно с подтверждением Windows.
- Arduino USB HID использует совместимое внешнее устройство с подготовленной прошивкой.
Если выбранный способ ввода недоступен, Automation Runtime показывает ошибку и не переключается на другой способ автоматически.
Запуск и остановка
- Откройте проект и сценарий в Automation Manager.
- Проверьте целевое окно, монитор, масштаб и способ ввода.
- Запустите сценарий под наблюдением и держите доступной аварийную остановку.
- После каждого важного действия проверяйте ожидаемое состояние интерфейса.
Безопасность
- Сценарий выполняется с правами запущенной программы и может читать или изменять доступные ему файлы.
- Не запускайте непроверенный сценарий и храните рабочую папку в системе контроля версий или резервной копии.
- Не используйте Alpha-версию для ненаблюдаемого управления критическими системами.
Типичные проблемы
- Шаблон не найден: проверьте масштаб, тему, состояние окна, область поиска и качество шаблона.
- Текст не найден: проверьте Tesseract, язык OCR и качество области.
- Координаты смещены: проверьте монитор, масштаб Windows и положение окна.
- Ввод не начинается: повторно проверьте выбранный способ ввода и уровень прав целевого окна.