ISendInputScriptingApi

Отправляет текст, нажатия клавиш и движения мыши через выбранный симулятор ввода. Сервис внедряется в C# Action; обычный C# класс получает его через конструктор или параметр. Регистрацию предоставляет модуль Roxy работающего EyeAuras, одной ссылки на SDK недостаточно.

В примерах [Inject] заполняет свойство при настройке экземпляра скрипта. Одного get; init; для внедрения недостаточно. Альтернатива — [Dependency] из Unity; настройка описана в руководстве по DI.

Отправить текст и клавишу

Откройте редактор текста и оставьте его активным перед выполнением этого C# Action:

using Microsoft.AspNetCore.Components;
using EyeAuras.Roxy.Api;

[Inject] public ISendInputScriptingApi SendInput { get; init; }

SendInput.TargetWindow = null;
SendInput.Text("hello");
SendInput.KeyPress(Key.Enter);

При стандартном Windows Input текст и Enter отправляются активному приложению. Методы синхронные, результат — побочный эффект в приложении, а не возвращённое значение или подтверждение обработки ввода.

Text принимает текст, а не грамматику AutoHotkey Send. Для отдельных клавиш используйте KeyPress, KeyDown, KeyUp; для сочетания — Gesture(HotkeyGesture, InputEventType, int?). После ручного KeyDown нужен парный KeyUp.

Кликнуть в точке экрана

Для стандартного Windows Input без целевого окна координаты абсолютные, в пространстве виртуального рабочего стола:

using Microsoft.AspNetCore.Components;
using EyeAuras.Roxy.Api;

[Inject] public ISendInputScriptingApi SendInput { get; init; }

SendInput.TargetWindow = null;
SendInput.MouseLeftClick(100, 200);
Log.Info($"Курсор после клика: {SendInput.CursorPosition}");

Перегрузка с координатами сначала двигает курсор, затем кликает. Положение не восстанавливается. MouseMoveTo(x, y) задаёт точку, MouseMoveBy(x, y) — смещение; есть перегрузки с WinPoint. MouseRightClick, MouseClick, MouseDown, MouseUp работают с кнопками MouseButton; MouseLeftDoubleClick выполняет два клика с интервалом.

TargetWindow передаётся контроллеру, но не гарантирует фоновый ввод. Стандартный Windows Input обёрнут в ForegroundInputController: при ненулевом TargetWindow он запрашивает активацию окна, а абсолютную точку переводит через начало DwmFrameBounds в экранную перед передачей mapper. Без цели точка уже экранная. Относительное движение остаётся смещением. У других контроллеров семантика может отличаться; это не универсальный режим AHK CoordMode и не Win32 client origin. Преобразования относительно рамки окна описаны в карте окон.

Настроить задержки и симулятор

В реализации EyeAuras 20fd3d4:

Аргумент задержки int? переопределяет настройку конкретного вызова. Например, SendInput.KeyPress(Key.F1, 20) задаёт явную задержку. Доступные id берите из IInputSimulatorProvider / IUserInputSmootherProvider, а не из предположения, что драйвер установлен на любой машине.

Проверить состояние и остановить последовательность

IsKeyDown(Key) и IsMouseDown(MouseButton) возвращают bool через состояние выбранного контроллера. Это не подтверждённый эквивалент всех режимов logical/physical AutoHotkey.

using Microsoft.AspNetCore.Components;
using EyeAuras.Roxy.Api;

[Inject] public ISendInputScriptingApi SendInput { get; init; }

for (var i = 0; i < 3; i++)
{
    cancellationToken.ThrowIfCancellationRequested();
    SendInput.KeyPress(Key.F1);
    Sleep(250);
}

Пример отправляет до трёх нажатий F1. Остановка скрипта прерывает Sleep и предотвращает следующие итерации. Однако сами операции API этой версии не принимают токен: внутренний Send использует CancellationToken.None, а Text синхронно ждёт контроллер без токена запуска. Не считайте остановку скрипта мгновенной отменой уже начатого ввода. Неготовый симулятор или запрещённое foreground-окно могут вызвать исключение.

Сервис привязан к контексту скрипта; не освобождайте внедрённые общие сервисы самостоятельно. Для UI-кода учитывайте синхронное ожидание: это не асинхронный API диспетчера.

Связанные операции и справка

Хоткеи и хуки, окна, перенос ввода с AHK. Полный контракт, включая координатные перегрузки, сверяйте с EyeAuras.Roxy.Api.ISendInputScriptingApi в SDK/XML своей версии. Устаревший ISendInputUnstableScriptingApi не добавляет возможностей.