Как мигрировать с устаревшего Input Manager Unity на Input System без поломки управления
Коротко о главном
Как перенести проект Unity 6 со старого Input Manager на Input System, не ломая управление игроком, интерфейс UI или оставшиеся вызовы Input.
Вы устанавливаете Input System, нажимаете Play, и Unity выбрасывает ошибку: вы пытаетесь читать ввод через класс UnityEngine.Input, но Active Input Handling уже указывает на пакет Input System. Или Play Mode запускается, а меню паузы больше не реагирует ни на один клик.
Эта статья показывает безопасный порядок миграции существующего проекта Unity 6 с устаревшего Input Manager на новый Input System без поломки управления или UI. Оставьте оба бэкенда включенными, замените свои вызовы Input, исправьте EventSystem, а затем отключите старый менеджер только когда все снова работает. Шаги следуют официальной документации Input System на 20 ноября 2026 года. Установите текущий пакет Input System из Package Manager. Не фиксируйте версию пакета из этой статьи, потому что выйдут более новые релизы.
Зачем мигрировать в Unity 6
Руководство Unity теперь рассматривает встроенный Input Manager как устаревшую функцию. Он deprecated, не рекомендуется для новых проектов, и Unity говорит, что он будет удален в будущей версии редактора. Старый менеджер остается доступным, чтобы существующие проекты могли продолжать работать. Запланированное переключение все равно лучше, чем ждать, пока будущее обновление не удалит старый бэкенд за вас.
Оставьте оба бэкенда включенными во время миграции
Если ваш проект не включает Input System, откройте Window > Package Manager, переключитесь на Unity Registry и установите пакет Input System. Начиная с Unity 6.1, некоторые шаблоны проектов уже добавляют его. Пустые проекты часто не добавляют.
Во время установки Unity спрашивает, включить ли бэкенды Input System и отключить бэкенды Input Manager. Если вы выберете Yes, редактор перезапустится с активной только новой системой. Каждый оставшийся вызов Input.GetAxis или Input.GetButton тогда провалится, а меню uGUI, которые все еще используют старый input module, провалятся вместе с ними.
Вместо этого установите бэкенд самостоятельно. Перейдите в Edit > Project Settings > Player, откройте Other Settings и установите Active Input Handling в Both. Редактор перезапустится. В этом режиме Unity определяет и ENABLE_LEGACY_INPUT_MANAGER, и ENABLE_INPUT_SYSTEM, так что старый и новый код могут работать бок о бок.
#if ENABLE_INPUT_SYSTEM
// New Input System backends are enabled.
#endif
#if ENABLE_LEGACY_INPUT_MANAGER
// Old Input Manager backends are enabled.
#endif
Трактуйте Both как мост. Оставьте его включенным, пока ваши собственные скрипты, EventSystem и любые сторонние ассеты не переедут. Переключитесь на Input System Package (New) только после того, как Play Mode и билд работают без исключения и с работающим UI.
Замените GetAxis и GetButton на Actions
Рекомендуемый рабочий процесс: читать именованные actions, а не сырые кнопки устройства. Если вам не нужно больше одного action asset, назначьте один asset как действия для всего проекта.
Откройте Edit > Project Settings > Input System Package и создайте или назначьте дефолтные действия для всего проекта, если они не установлены. Дефолты включают карту Player и карту UI с действиями вроде Move (значение Vector2) и Jump, уже привязанными для клавиатуры, мыши, геймпада, касаний и XR. Вы достигаете их через InputSystem.actions. Они включены по умолчанию и предзагружены при запуске, а в редакторе каждый раз при входе в Play Mode.
Найдите каждое действие один раз, затем читайте его каждый кадр. Поиск действия по имени каждый раз, как делал Input.GetAxis("Horizontal"), это медленный путь в новом API.
using UnityEngine;
using UnityEngine.InputSystem;
public class PlayerMovement : MonoBehaviour
{
InputAction moveAction;
InputAction jumpAction;
void Start()
{
moveAction = InputSystem.actions.FindAction("Move");
jumpAction = InputSystem.actions.FindAction("Jump");
}
void Update()
{
Vector2 move = moveAction.ReadValue<Vector2>();
if (jumpAction.WasPressedThisFrame())
{
// jump
}
}
}
Имена в пространстве имен UnityEngine.InputSystem соответствуют старым вызовам следующим образом:
Input.GetAxis("Horizontal")иInput.GetAxis("Vertical")становятсяmoveAction.ReadValue<Vector2>()Input.GetButton("Jump")становитсяjumpAction.IsPressed()Input.GetButtonDownстановитсяWasPressedThisFrame()Input.GetButtonUpстановитсяWasReleasedThisFrame()Input.GetKey(KeyCode.Space)становитсяKeyboard.current.spaceKey.isPressedInput.GetMouseButton(0)становитсяMouse.current.leftButton.isPressedInput.mousePositionстановитсяMouse.current.position.ReadValue()
Две детали важны, если вы хотите, чтобы управление ощущалось так же. Дефолтное действие Move это 2D значение, так что старые оси Horizontal и Vertical становятся одним вектором, а не двумя флоатами. И ReadValue не применяет старое сглаживание Gravity и Sensitivity, так что клавиша или кнопка достигает полного значения немедленно. Если ваше движение полагалось на этот рамп, вам нужно будет воссоздать его специально. У Input.GetAxisRaw нет прямого эквивалента. ReadUnprocessedValue() отличается от ReadValue только когда к действию прикреплены процессоры.
Прямое чтение устройства вроде Keyboard.current это быстрая замена, а не долгосрочный рабочий процесс, и текущее устройство может быть null, когда это оборудование отсутствует.
Несколько старых возможностей Input Manager все еще зависят от вашей версии Unity. Начиная с Unity 6.4, функции событий мыши MonoBehaviour вроде OnMouseDown работают с Input System. На более ранних релизах Unity 6 они могут ничего не делать, как только активен только новый бэкенд. Если ваш проект использует location, compass или device orientation, проверьте документацию Input System для вашего редактора, прежде чем отключать старый менеджер. IMGUI (OnGUI) несовместим с Input System, так что дебаг-меню, построенное таким образом, может потребовать оставить Both.
Сохраните работу UI
Если вы используете Unity UI (uGUI), вам всегда нужен input module на EventSystem, чтобы передавать Input System в UI. Старый StandaloneInputModule все еще общается с устаревшим Input Manager. Когда Active Input Handling установлен только на новый пакет, этот модуль является частым источником исключения UnityEngine.Input.
Выберите EventSystem в сцене. Если пакет Input System установлен, Inspector предлагает кнопку, которая заменяет StandaloneInputModule на InputSystemUIInputModule. Новый модуль предварительно настроен с дефолтными UI actions. Когда Active Input Handling уже установлен на новый пакет или на Both, Unity также добавляет новый модуль автоматически, если вы помещаете свежий элемент uGUI в сцену.
UI Toolkit другой. Начиная с Unity 2023.2, что включает Unity 6, UI Toolkit может читать UI actions из действий для всего проекта без дополнительного модуля. Вам нужен InputSystemUIInputModule плюс EventSystem, когда UI Toolkit и uGUI разделяют одну сцену.
Если вы также используете компонент PlayerInput, назначьте один и тот же action asset для PlayerInput и для InputSystemUIInputModule, и установите поле UI Input Module на PlayerInput. Тогда одно и то же назначение устройства управляет и игроком, и UI. Если ваши скрипты читают actions, пока используется PlayerInput, читайте PlayerInput.actions, а не InputSystem.actions, потому что PlayerInput хранит отфильтрованную копию для устройства каждого игрока.
Исключение и оставшиеся вызовы Input
Ошибка времени выполнения обычно гласит: InvalidOperationException: You are trying to read Input using the UnityEngine.Input class, but you have switched active Input handling to Input System package in Player Settings. Она появляется, когда Active Input Handling установлен на Input System Package (New), а что-то все еще вызывает UnityEngine.Input.
Прочитайте stack trace, прежде чем менять случайные скрипты. Он часто начинается в StandaloneInputModule или BaseInput.GetButtonDown, а не в вашем классе движения. После того как вы исправите EventSystem, найдите в своем коде Input.GetAxis, Input.GetButton, Input.GetKey, Input.GetMouseButton и Input.mousePosition. Затем проверьте сторонние ассеты и плагины. Установка Active Input Handling обратно на Both это допустимый временный шаг. Долгосрочное решение: мигрировать вызывающий код или обновить плагин.
Когда PlayerInput стоит того
Компонент PlayerInput опционален. Добавьте его, когда вы хотите Send Messages (OnJump, OnMove(InputValue value)), Invoke Unity Events или PlayerInputManager для локального мультиплеера. Однопользовательская игра, которая уже опрашивает в Update, может остаться с FindAction и ReadValue.
Короткий чеклист миграции
- Установите текущий пакет Input System из Package Manager, затем установите Active Input Handling в Both.
- Создайте или назначьте дефолтные действия для всего проекта.
- Замените свои собственные вызовы
Input. Найдите каждое действие один раз, затем читайте его каждый кадр. - Если вы используете uGUI, замените
StandaloneInputModuleнаInputSystemUIInputModuleи прокликайте меню клавиатурой и геймпадом. - Проверьте события
OnMouse, касания, location, compass и IMGUI на соответствие вашей версии Unity. - Обновите плагины, которые все еще вызывают
UnityEngine.Input, или оставьте Both включенным, пока не выйдет исправление. - Когда Play Mode и билд работают без исключения и с работающим UI, установите Active Input Handling в Input System Package (New).
Прежде чем переключить этот последний переключатель, пройдите через движение, меню и экранные кнопки. Ввод это клиентская тема движка. horizOn это игровой бэкенд с Unity SDK для аккаунтов, облачных сохранений, таблиц лидеров и внутриигровых новостей. Миграция Input System не меняет то, как вы используете этот SDK, и он не заменяет и не оборачивает стек ввода Unity.