InputEvent

public int Device { get; set; }

Метаданные ID устройства события. Изменение не выбирает физическое устройство и не отправляет нажатие; setter вызывает Changed. Допустимы специальные отрицательные значения. InputMap может фильтровать binding по Device, но прямой IsMatch/Accumulate не обязан проверять его одинаково во всех подтипах.

public bool Accumulate(InputEvent withEvent);

Пытается объединить withEvent с этим объектом и при успехе изменяет получатель. Не отправляет ввод и не управляет глобальным Input.UseAccumulatedInput. Базовый тип возвращает false; проверен InputEventMouseMotion: суммы Relative/ScreenRelative, последние Position/GlobalPosition/Velocity/ScreenVelocity. Требуются совместимые window/state/modifiers. Прямой вызов MouseMotion.Accumulate не проверяет Device; при разделении устройств отфильтруйте их сами. Это не универсальное сложение всех полей и не гарантия слияния любого типа.

public string AsText();

Человекочитаемая метка конкретного события; формат и локализация зависят от подтипа. Не используйте для сериализации, сравнения или стабильного action ID. InputEventAction может показать первую привязку из InputMap, а не своё имя Action; без привязок результат может быть пустым.

public float GetActionStrength(StringName action, bool exactMatch = false);

Сила указанного action именно в этом событии, не текущее агрегированное Input-состояние. Цифровое нажатие обычно 1, отпускание 0; ось учитывает deadzone привязки, а InputEventAction использует сохранённую Strength только при Pressed. Несовпадающее событие возвращает 0. Action должен существовать в InputMap; неизвестное имя диагностируется, а не является безопасным TryGet.

public int GetDevice();

Возвращает Device этого события. Это метаданные объекта, не запрос подключённых устройств или состояния клавиатуры.

public bool IsAction(StringName action, bool exactMatch = false);

Проверяет совпадение данного события с существующим action в InputMap независимо от Pressed/released и силы. Поэтому true возможно для отпускания и оси внутри deadzone. exactMatch=false по умолчанию допускает дополнительные modifiers по правилам подтипа. Не изменяет Input и не означает, что action сейчас удерживается.

public bool IsActionPressed(StringName action, bool allowEcho = false, bool exactMatch = false);

True, если событие соответствует action и его action pressed-state активен. Echo клавиатуры исключён, пока allowEcho=false. Это проверка данного события, не IsActionJustPressed глобального Input и не автоматическое потребление события. exactMatch управляет совпадением modifiers/направления по типу события. Для оси результат зависит от deadzone, а не только факта движения.

public bool IsActionReleased(StringName action, bool exactMatch = false);

True для совпадающего action с неактивным pressed-state. Не является универсальным доказательством физического отпускания: проверены canceled mouse и ось внутри deadzone, для которых метод тоже true. Проверяйте IsCanceled и конкретный тип, если важна причина. Nonexact key release может совпасть с привязкой, modifiers которой уже отпущены. Не равно глобальному Input.IsActionJustReleased.

public bool IsActionType();

Классифицирует подтип как пригодный для action-событий, не проверяя конкретную настройку InputMap. Клавиша возвращает true, MouseMotion — false в проверке. Это не IsAction, не проверка Pressed и не разрешение изменять InputMap.

public bool IsCanceled();

Возвращает флаг отмены события. При canceled базовые IsPressed и IsReleased оба false; однако IsActionReleased может вернуть true через action matching. Отмена не равна обычному отпусканию. Переходы canceled при потере реального фокуса окна здесь не проверялись.

public bool IsEcho();

Показывает repeat/echo конкретного события там, где подтип его поддерживает, например InputEventKey. База возвращает false. Не означает двойной клик или автоматически повторяемое игровое действие. IsActionPressed по умолчанию отбрасывает echo.

public bool IsMatch(InputEvent @event, bool exactMatch = true);

Сравнивает события по правилам конкретного подтипа, а не все сериализуемые поля. По умолчанию exactMatch=true, в отличие от IsAction. Pressed/strength/Device не обязаны определять результат. Сравнение разных подтипов может быть несимметричным: InputEventAction способен проверить key через свой InputMap action, а key не обязан совпасть с Action обратно. Не используйте как универсальный equality/hash.

public bool IsPressed();

Возвращает сохранённый pressed && !canceled для этого объекта. Само событие может быть создано вручную и не отражать OS-состояние. Для action с axis/deadzone используйте соответствующий action-запрос, а для текущего удержания — Input. Не проверяет тип события.

public bool IsReleased();

Возвращает !pressed && !canceled. Для событий нажатия это локальный признак отпущенного состояния; сам по себе не подтверждает реальный переход клавиши/кнопки, особенно у синтетических или других подтипов. Не равен IsActionReleased и не читает глобальное Input-состояние.

public void SetDevice(int device);

Изменяет Device и испускает Resource.Changed. Не переназначает action binding, не подключает устройство и не подаёт OS-событие. Не изменяйте разделяемое входное событие во время рассылки, если другой код ещё использует исходные метаданные.

public InputEvent XformedBy(Transform2D xform, Vector2? localOfs = default);

Преобразует координатные события по правилам подтипа. Для MouseMotion проверены новая копия, position = xform*(position+localOfs), basis-only преобразование Relative/Velocity и сохранение ScreenRelative/ScreenVelocity/GlobalPosition. Для Key базовая реализация возвращает тот же объект и тот же C# wrapper: независимая копия не гарантирована. Не Dispose такой alias пока исходное событие используется. Это не перенос события между OS-окнами и не отправка ввода.

public const long DeviceIdEmulation = -1;

Специальное значение −1 для эмулированных событий, например mouse из touch. Не означает, что любой созданный вручную InputEventAction автоматически получает этот ID. Не является OS handle или номером игрока.

public const long DeviceIdKeyboard = 16;

Значение 16, используемое конструктором InputEventKey как категория клавиатуры. Не индекс клавиши, scan code или гарантированное различение нескольких физических клавиатур.

public const long DeviceIdMouse = 32;

Значение 32, используемое конструктором событий мыши. Не индекс кнопки и не OS window ID. Физическая поддержка нескольких мышей этим значением не подтверждается.