Danro-Jump/GUIDES/applied_usage/InputSystem.md

Полное руководство по новому Input System

В Unity старая система Input.GetKey() заменена на современную, модульную Input System (UnityEngine.InputSystem). Она решает проблемы поддержки множества геймпадов, кроссплатформенности и переназначения клавиш.

1. Быстрый способ (Прямое чтение, как в старой системе)

Хотя это не самый гибкий способ, он удобен для быстрого прототипирования. Мы обращаемся к текущему активному устройству (Keyboard.current, Gamepad.current).

using UnityEngine.InputSystem;

public void Update()
{
    // Важно проверять на null, т.к. клавиатуры может не быть (на мобилках, консолях)
    if (Keyboard.current != null)
    {
        if (Keyboard.current.spaceKey.wasPressedThisFrame)
        {
            Jump();
        }
    }

    if (Gamepad.current != null)
    {
        // Чтение стика (возвращает Vector2 от -1 до 1)
        Vector2 moveInput = Gamepad.current.leftStick.ReadValue();
    }
}

2. Правильный способ (Input Actions Asset)

Рекомендуемый подход — создать файл .inputactions через редактор (Create -> Input Actions). В нем вы задаете "Действия" (Actions), например "Move" или "Jump", и привязываете к ним кнопки с разных устройств (Пробел на ПК, Кнопка А на Xbox, Экранный стик на телефоне).

Вариант 2А: Генерация C# класса (Рекомендуется для Zenject)

1. В инспекторе файла .inputactions поставьте галочку Generate C# Class.
2. Создайте класс (например, PlayerControls).

public class PlayerInputHandler : MonoBehaviour, IDisposable
{
    private PlayerControls controls;

    private void Awake()
    {
        // Инициализируем сгенерированный класс
        controls = new PlayerControls();

        // ПОДПИСЫВАЕМСЯ НА СОБЫТИЯ
        // performed - кнопка нажата (и прошла порог чувствительности)
        controls.Gameplay.Jump.performed += OnJumpPerformed;
        // canceled - кнопка отпущена
        controls.Gameplay.Jump.canceled += OnJumpCanceled;
    }

    private void OnEnable()
    {
        // Важно: экшены по умолчанию выключены!
        controls.Gameplay.Enable(); 
    }

    private void OnDisable()
    {
        controls.Gameplay.Disable();
    }

    private void OnJumpPerformed(InputAction.CallbackContext context)
    {
        Debug.Log("Прыжок!");
    }

    private void Update()
    {
        // Чтение значений (например, вектора движения) в Update
        Vector2 movement = controls.Gameplay.Move.ReadValue<Vector2>();
        MoveCharacter(movement);
    }

    public void Dispose()
    {
        controls?.Dispose();
    }
}

3. Обработка виртуального / аппаратного ввода (COM-порты)

В проекте "Danro Jump" есть ComControllerInputBridge, который принимает сигналы от реального "железного" автомата через COM-порт.

Как обмануть Unity и заставить её думать, что нажата физическая кнопка геймпада? В Input System можно программно создавать виртуальные устройства и посылать в них события.

using UnityEngine.InputSystem;
using UnityEngine.InputSystem.LowLevel;

public class VirtualGamepadEmulator
{
    private Gamepad virtualGamepad;

    public void Initialize()
    {
        // Создаем виртуальный геймпад в системе
        virtualGamepad = InputSystem.AddDevice<Gamepad>("Virtual Gamepad");
    }

    // Этот метод вызывается, когда по COM-порту приходит сигнал
    public void TriggerVirtualJump()
    {
        if (virtualGamepad == null) return;

        // Генерируем событие "Кнопка А (южная кнопка) нажата"
        InputSystem.QueueStateEvent(virtualGamepad, new GamepadState
        {
            buttons = (uint)GamepadButton.South
        });
    }

    public void Cleanup()
    {
        if (virtualGamepad != null)
        {
            InputSystem.RemoveDevice(virtualGamepad);
        }
    }
}

Important

Если вы генерируете события ввода из фонового потока (от COM-порта), функция InputSystem.QueueStateEvent является потокобезопасной, но вызовы любых других Unity API (например, перемещение объекта) должны быть переданы в главный поток!