Jak przeprowadzić migrację ze starego Input Manager Unity do Input System bez psujenia sterowania
W skrócie
Migracja projektu Unity 6 ze starego Input Manager do Input System bez psujenia sterowania gracza, interfejsu lub pozostałych wywołań Input.
Instalujesz Input System, wciskasz Play, a Unity rzuca błąd: próbujesz odczytać input za pomocą klasy UnityEngine.Input, ale Active Input Handling już wskazuje na pakiet Input System. Albo Play Mode się uruchamia, ale menu pauzy nie odbiera już żadnego kliknięcia.
Ten artykuł pokazuje bezpieczną kolejność migracji istniejącego projektu Unity 6 ze starego Input Manager do nowego Input System bez psujenia sterowania lub interfejsu. Zostaw oba backendy włączone, zastąp swoje wywołania Input, napraw EventSystem, a stary manager wyłącz dopiero, gdy wszystko nadal działa. Kroki są zgodne z oficjalną dokumentacją Input System na dzień 20 listopada 2026. Zainstaluj aktualny pakiet Input System z Package Manager. Nie przypinaj wersji pakietu z tego artykułu, ponieważ ukaże się nowsze wydania.
Po co migrować w Unity 6
Podręcznik Unity traktuje teraz wbudowany Input Manager jako funkcję przestarzałą. Jest zdeprecjonowany, nie jest zalecany dla nowych projektów, a Unity mówi, że zostanie usunięty w przyszłej wersji edytora. Stary manager pozostaje dostępny, aby istniejące projekty mogły nadal działać. Zaplanowane przejście jest jednak lepsze niż czekanie, aż przyszła aktualizacja usunie stary backend za ciebie.
Zostaw oba backendy włączone podczas migracji
Jeśli twój projekt nie zawiera Input System, otwórz Window > Package Manager, przełącz na Unity Registry i zainstaluj pakiet Input System. Od Unity 6.1 niektóre szablony projektów już go dodają. Puste projekty często tego nie robią.
Podczas instalacji Unity pyta, czy włączyć backendy Input System i wyłączyć backendy Input Manager. Jeśli wybierzesz Yes, Edytor uruchomi się ponownie z aktywnym tylko nowym systemem. Każde pozostałe wywołanie Input.GetAxis lub Input.GetButton wtedy zawodzi, a menu uGUI, które nadal używają starego modułu input, zawodzą razem z nimi.
Ustaw backend samodzielnie. Przejdź do Edit > Project Settings > Player, otwórz Other Settings i ustaw Active Input Handling na Both. Edytor uruchomi się ponownie. W tym trybie Unity definiuje zarówno ENABLE_LEGACY_INPUT_MANAGER, jak i ENABLE_INPUT_SYSTEM, więc stary i nowy kod mogą działać obok siebie.
#if ENABLE_INPUT_SYSTEM
// New Input System backends are enabled.
#endif
#if ENABLE_LEGACY_INPUT_MANAGER
// Old Input Manager backends are enabled.
#endif
Traktuj Both jako pomost. Zostaw to włączone, aż twoje własne skrypty, EventSystem i wszystkie assety firm trzecich przejdą migrację. Przełącz na Input System Package (New) dopiero po tym, jak Play Mode i build działają bez wyjątku i z działającym interfejsem.
Zastąp GetAxis i GetButton akcjami
Zalecany przepływ pracy to odczytywanie nazwanych akcji, a nie surowych przycisków urządzenia. Jeśli nie potrzebujesz więcej niż jednego action asset, przypisz pojedynczy asset jako akcje ogólnoprojektowe.
Otwórz Edit > Project Settings > Input System Package i utwórz lub przypisz domyślne akcje ogólnoprojektowe, jeśli żadne nie są ustawione. Domyślne zawierają mapę Player i mapę UI, z akcjami takimi jak Move (wartość Vector2) i Jump, już zbindowanymi dla klawiatury, myszy, gamepada, dotyku i XR. Docierasz do nich przez InputSystem.actions. Są domyślnie włączone i są wstępnie ładowane przy starcie, a w Edytorze za każdym razem, gdy wchodzisz w Play Mode.
Znajdź każdą akcję raz, a następnie odczytuj ją co klatkę. Wyszukiwanie akcji po nazwie za każdym razem, jak robił to Input.GetAxis("Horizontal"), jest wolną ścieżką w nowym 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
}
}
}
Nazwy w przestrzeni nazw UnityEngine.InputSystem mapują się na stare wywołania w ten sposób:
Input.GetAxis("Horizontal")iInput.GetAxis("Vertical")stają sięmoveAction.ReadValue<Vector2>()Input.GetButton("Jump")staje sięjumpAction.IsPressed()Input.GetButtonDownstaje sięWasPressedThisFrame()Input.GetButtonUpstaje sięWasReleasedThisFrame()Input.GetKey(KeyCode.Space)staje sięKeyboard.current.spaceKey.isPressedInput.GetMouseButton(0)staje sięMouse.current.leftButton.isPressedInput.mousePositionstaje sięMouse.current.position.ReadValue()
Dwa szczegóły mają znaczenie, jeśli chcesz, aby sterowanie działało tak samo. Domyślna akcja Move to wartość 2D, więc stare osie Horizontal i Vertical stają się jednym wektorem, a nie dwoma floatami. A ReadValue nie stosuje starego wygładzania Gravity i Sensitivity, więc klawisz lub przycisk osiąga pełną wartość natychmiast. Jeśli twój ruch polegał na tej rampie, będziesz musiał odtworzyć ją celowo. Input.GetAxisRaw nie ma bezpośredniego odpowiednika. ReadUnprocessedValue() różni się od ReadValue tylko wtedy, gdy do akcji są dołączone procesory.
Bezpośrednie odczyty urządzenia takie jak Keyboard.current są szybkim zastępstwem, a nie długoterminowym przepływem pracy, a bieżące urządzenie może być null, gdy brakuje tego sprzętu.
Kilka starszych funkcji Input Manager nadal zależy od twojej wersji Unity. Od Unity 6.4 funkcje zdarzeń myszy MonoBehaviour, takie jak OnMouseDown, działają z Input System. W starszych wydaniach Unity 6 mogą nic nie robić, gdy tylko nowy backend jest aktywny. Jeśli twój projekt używa lokalizacji, kompasu lub orientacji urządzenia, sprawdź dokumentację Input System dla twojego edytora, zanim wyłączysz stary manager. IMGUI (OnGUI) nie jest kompatybilny z Input System, więc menu debugowania zbudowane w ten sposób może wymagać pozostawienia Both.
Utrzymaj działający interfejs
Jeśli używasz Unity UI (uGUI), zawsze potrzebujesz modułu input na EventSystem, aby przekazać Input System do interfejsu. Starszy StandaloneInputModule nadal rozmawia ze starym Input Manager. Gdy Active Input Handling jest ustawiony tylko na nowy pakiet, ten moduł jest częstym źródłem wyjątku UnityEngine.Input.
Zaznacz EventSystem w scenie. Jeśli pakiet Input System jest zainstalowany, Inspector oferuje przycisk, który zastępuje StandaloneInputModule modułem InputSystemUIInputModule. Nowy moduł jest wstępnie skonfigurowany z domyślnymi akcjami UI. Gdy Active Input Handling jest już ustawiony na nowy pakiet lub na Both, Unity również automatycznie dodaje nowy moduł, jeśli umieścisz świeży element uGUI w scenie.
UI Toolkit jest inny. Od Unity 2023.2, co obejmuje Unity 6, UI Toolkit może odczytywać akcje UI z twoich akcji ogólnoprojektowych bez dodatkowego modułu. Potrzebujesz InputSystemUIInputModule plus EventSystem, gdy UI Toolkit i uGUI dzielą tę samą scenę.
Jeśli używasz również komponentu PlayerInput, przypisz ten sam action asset do PlayerInput i do InputSystemUIInputModule, i ustaw pole UI Input Module na PlayerInput. Wtedy to samo przypisanie urządzenia steruje zarówno graczem, jak i interfejsem. Jeśli twoje skrypty odczytują akcje podczas używania PlayerInput, odczytuj PlayerInput.actions, a nie InputSystem.actions, ponieważ PlayerInput przechowuje filtrowaną kopię dla urządzenia każdego gracza.
Wyjątek i pozostałe wywołania Input
Błąd czasu wykonania zwykle brzmi: 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. Pojawia się, gdy Active Input Handling jest ustawiony na Input System Package (New), a coś nadal wywołuje UnityEngine.Input.
Przeczytaj stack trace, zanim zaczniesz zmieniać przypadkowe skrypty. Często zaczyna się w StandaloneInputModule lub BaseInput.GetButtonDown, a nie w twojej klasie ruchu. Po naprawieniu EventSystem przeszukaj swój własny kod pod kątem Input.GetAxis, Input.GetButton, Input.GetKey, Input.GetMouseButton i Input.mousePosition. Następnie sprawdź assety i wtyczki firm trzecich. Ustawienie Active Input Handling z powrotem na Both to prawidłowy tymczasowy krok. Trwała naprawa to migracja wywołującego lub aktualizacja wtyczki.
Kiedy PlayerInput jest wart uwagi
Komponent PlayerInput jest opcjonalny. Dodaj go, gdy chcesz Send Messages (OnJump, OnMove(InputValue value)), Invoke Unity Events lub PlayerInputManager dla lokalnej gry wieloosobowej. Gra jednoosobowa, która już odpytuje w Update, może pozostać przy FindAction i ReadValue.
Krótka lista kontrolna migracji
- Zainstaluj aktualny pakiet Input System z Package Manager, następnie ustaw Active Input Handling na Both.
- Utwórz lub przypisz domyślne akcje ogólnoprojektowe.
- Zastąp swoje własne wywołania
Input. Znajdź każdą akcję raz, a następnie odczytuj ją co klatkę. - Jeśli używasz uGUI, zastąp
StandaloneInputModulemodułemInputSystemUIInputModulei kliknij przez menu za pomocą klawiatury i gamepada. - Sprawdź zdarzenia
OnMouse, dotyk, lokalizację, kompas i IMGUI względem twojej wersji Unity. - Zaktualizuj wtyczki, które nadal wywołują
UnityEngine.Input, lub zostaw Both włączone, aż istnieje poprawka. - Gdy Play Mode i build działają bez wyjątku i z działającym interfejsem, ustaw Active Input Handling na Input System Package (New).
Zanim przełączysz ten ostatni przełącznik, przejdź przez ruch, menu i przyciski na ekranie. Input to temat silnika po stronie klienta. horizOn to backend gry z Unity SDK do kont, zapisu w chmurze, tablic wyników i wiadomości w grze. Migracja Input System nie zmienia sposobu używania tego SDK i nie zastępuje ani nie owija stosu input Unity.