Устранение неполадок#
Жесты не срабатывают#
Сначала опробуйте простой встроенный жест в обычном, не полноэкранном окне браузера.
Проверьте меню области уведомлений/строки меню. В Windows выберите Возобновить жесты, если пункт предлагается; на Mac снова щёлкните Приостановить жесты, если он отмечен. Проверьте Параметры → Клавиша паузы / возобновления, если сочетание поставило движок на паузу.
Выйдите из полноэкранного режима. Автоматическое подавление полноэкранного режима может остановить и жесты мыши, и действия кромок, даже когда ручная пауза выключена.
Выберите программу в настройках и проверьте Отключить жесты в этой программе. Также проверьте переключатель Вкл / Откл отдельной привязки, Использовать и общие жесты, кнопку-триггер и дополнительные шаги.
После нажатия кнопки сразу двигайтесь и рисуйте более длинный жест. Настройте Сколько ждать неподвижности до обычного щелчка и Чувствительность линии в Параметрах.
Если обратной связи нет, проверьте Показывать след и Показывать имя жеста при рисовании. Скрытый след сам по себе не означает, что распознавание выключено.
В Windows ввод использует SendInput. Обычно запущенный экземпляр может не суметь послать клавиши/щелчки в программу с повышенными правами из-за Windows UIPI. Сначала проверьте на программе без повышения прав; если нужно управлять окном администратора, запустите Mousetroke с соответствующим повышением. Это не позволяет посылать ввод на защищённый рабочий стол.
На Mac проверьте Универсальный доступ для установленной копии. Если мастер по-прежнему запрашивает Мониторинг ввода, выдайте и его. Изменения разрешений могут обнаруживаться несколько секунд. Используйте Перезапустить Mousetroke, когда это предлагается, если ввод всё ещё не начинается. Запись экрана не требуется. Перемещение или замена копии через браузер может снова потребовать одобрения при первом открытии.
SmartScreen или Gatekeeper блокирует первый запуск#
Windows: возьмите официальный исполняемый файл со страницы выпуска, проверьте контрольную сумму, затем используйте Подробнее → Выполнить в любом случае. Mac: установите в Программы, затем используйте Системные настройки → Конфиденциальность и безопасность → Всё равно открыть; более старые macOS также поддерживают правый щелчок → Открыть. Полную последовательность см. в установке.
Программа не получает нажатия клавиш#
Попробуйте сочетание на физической клавиатуре. Проверьте, активна ли программа, или включите Сначала активировать окно под курсором. Подтвердите параметр цели жеста и используйте верный синтаксис: ^ — это Control, а # на Mac — Command. Разделяйте зависимые шаги коротким {SLEEP 100}, если программе нужно время, чтобы открыть меню или диалог.
Последовательности клавиш Mac пропускают лексемы мыши/колеса, лексемы клавиш медиа/громкости, Insert, Print Screen, Break и F21–F24. Для действий медиа/громкости используйте Медиа и система. Неподдерживаемые параметры помечены в редакторе; смотрите и журнал.
Ctrl+Alt+Del — это Secure Attention Sequence Windows и не может быть послан как обычный синтетический ввод. Используйте Ctrl+Shift+Esc для диспетчера задач, Win+L для блокировки или shutdown /l для выхода из системы. Подробности в синтаксисе отправки клавиш.
Неправильный ввод IME или текста#
Обычные символы отправки клавиш обозначают позиции американской клавиатуры, а не произвольный текст Юникода. Одни прописные буквы не добавляют Shift. Lua ms.keys(text, true) выдаёт текст Юникода, но по-прежнему интерпретирует символы синтаксиса вроде ^ и {.
Для текста с обильной пунктуацией, нелатинского текста или программ с необычной работой IME используйте рецепт вставки с восстановлением буфера обмена. Восстановление этими API сохраняет только текст, не изображения и не другие форматы буфера. Некоторым программам нужна более длинная задержка перед восстановлением буфера обмена.
Ошибки Lua#
Убедитесь, что код определяет function ms_action(...) ... end. Среда пишет ошибки загрузки и выполнения в журнал среды выполнения. Откройте его через О программе → Открыть журнал. Используйте ms.log для значений и ms.show_toast для краткой экранной контрольной точки. Неподдерживаемая функция Mac может только записать предупреждение и вернуть nil; не считайте отсутствующее значение успехом.
Вызовы обнаружения/состояния окон Mac требуют разрешение универсального доступа; запросы состояния клавиш без него возвращают false. Если результатов нет, сначала проверьте это разрешение. Межпрограммный режим поверх всех и числовая яркость по-прежнему не поддерживаются; встроенные действия клавиш яркости не дают процента. На обеих платформах ms.get_brightness / ms.set_brightness при неудаче возвращают nil.
Лимит выделения Lua — 8 МиБ. Таймаута выполнения скрипта нет; избегайте бесконечных циклов и см. основы Lua про блокирующее поведение.
Удалённый рабочий стол и игры#
Удалённый рабочий стол, виртуальные машины и приложения 3D/игр могут нуждаться в тех же кнопках мыши для перетаскивания или иначе обрабатывать синтетический ввод. Добавьте исключение для программы или поставьте паузу, пока ими пользуетесь. Оконным играм может понадобиться явное исключение, потому что определение полноэкранного режима не применяется. Проверяйте сочетания в обычной локальной программе, чтобы отделить проблему последовательности клавиш от обработки ввода приложением.
Сообщить об ошибке#
Используйте О программе → Обратная связь → Открыть или GitHub Issues. Укажите версию приложения, версию ОС, затронутую программу, жест и действие, ожидаемый результат и шаги воспроизведения. Приложите соответствующий журнал из О программе → Открыть журнал и минимальную экспортированную конфигурацию, если это полезно. Перед отправкой просмотрите вложения на частный текст, заголовки окон, пути или аргументы команд.