Come migrare dal vecchio Input Manager di Unity al nuovo Input System senza bloccare i controlli
In breve
Migra un progetto Unity 6 dal vecchio Input Manager al nuovo Input System senza bloccare i controlli del giocatore, l'interfaccia o le chiamate Input.
Installi l'Input System, premi Play e Unity genera un errore: stai tentando di leggere l'input con la classe UnityEngine.Input, ma Active Input Handling punta già al pacchetto Input System. Oppure Play Mode si avvia e il menu pausa non riceve più un singolo clic.
Questo articolo mostra un ordine sicuro per migrare un progetto Unity 6 esistente dal vecchio Input Manager al nuovo Input System senza bloccare i controlli o l'interfaccia. Mantieni attivi entrambi i backend, sostituisci le tue chiamate Input, correggi l'EventSystem e disattiva il vecchio manager solo quando tutto funziona ancora. I passaggi seguono la documentazione ufficiale dell'Input System aggiornata al 20 novembre 2026. Installa il pacchetto Input System corrente dal Package Manager. Non fissare una versione del pacchetto da questo articolo, perché usciranno release più recenti.
Perché migrare in Unity 6
Il manuale di Unity ora tratta l'Input Manager integrato come una funzionalità legacy. È deprecato, non è consigliato per nuovi progetti e Unity afferma che verrà rimosso in una versione futura dell'editor. Il vecchio manager rimane disponibile affinché i progetti esistenti possano continuare a funzionare. Un passaggio pianificato è comunque meglio che aspettare fino a quando un futuro aggiornamento rimuove il vecchio backend al posto tuo.
Mantieni attivi entrambi i backend mentre migri
Se il tuo progetto non include l'Input System, apri Window > Package Manager, passa a Unity Registry e installa il pacchetto Input System. Da Unity 6.1 in poi, alcuni template di progetto lo aggiungono già. I progetti vuoti spesso non lo includono.
Durante l'installazione, Unity chiede se abilitare i backend dell'Input System e disabilitare i backend dell'Input Manager. Se scegli Yes, l'Editor si riavvia con solo il nuovo sistema attivo. Ogni chiamata Input.GetAxis o Input.GetButton rimasta fallisce e i menu uGUI che usano ancora il vecchio modulo di input falliscono con loro.
Imposta tu stesso il backend. Vai su Edit > Project Settings > Player, apri Other Settings e imposta Active Input Handling su Both. L'Editor si riavvierà. In quella modalità, Unity definisce sia ENABLE_LEGACY_INPUT_MANAGER che ENABLE_INPUT_SYSTEM, quindi il vecchio e il nuovo codice possono girare fianco a fianco.
#if ENABLE_INPUT_SYSTEM
// New Input System backends are enabled.
#endif
#if ENABLE_LEGACY_INPUT_MANAGER
// Old Input Manager backends are enabled.
#endif
Tratta Both come un ponte. Lascialo attivo finché i tuoi script, l'EventSystem e qualsiasi asset di terze parti non sono passati al nuovo sistema. Passa a Input System Package (New) solo dopo che Play Mode e una build funzionano senza l'eccezione e con un'interfaccia funzionante.
Sostituisci GetAxis e GetButton con le Actions
Il flusso di lavoro consigliato è leggere azioni nominate, non pulsanti grezzi del dispositivo. A meno che tu non abbia bisogno di più di un asset di azioni, assegna un singolo asset come azioni a livello di progetto.
Apri Edit > Project Settings > Input System Package e crea o assegna le azioni predefinite a livello di progetto se non ne è impostata nessuna. Le impostazioni predefinite includono una mappa Player e una mappa UI, con azioni come Move (un valore Vector2) e Jump, già mappate per tastiera, mouse, gamepad, touch e XR. Le raggiungi tramite InputSystem.actions. Sono abilitate per impostazione predefinita e sono precaricate all'avvio, e nell'Editor ogni volta che entri in Play Mode.
Trova ogni azione una volta, poi leggila ogni frame. Cercare l'azione per nome ogni volta, come faceva Input.GetAxis("Horizontal"), è il percorso lento nella nuova 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
}
}
}
I nomi nel namespace UnityEngine.InputSystem si mappano alle vecchie chiamate così:
Input.GetAxis("Horizontal")eInput.GetAxis("Vertical")diventanomoveAction.ReadValue<Vector2>()Input.GetButton("Jump")diventajumpAction.IsPressed()Input.GetButtonDowndiventaWasPressedThisFrame()Input.GetButtonUpdiventaWasReleasedThisFrame()Input.GetKey(KeyCode.Space)diventaKeyboard.current.spaceKey.isPressedInput.GetMouseButton(0)diventaMouse.current.leftButton.isPressedInput.mousePositiondiventaMouse.current.position.ReadValue()
Due dettagli contano se vuoi che i controlli abbiano la stessa sensazione. L'azione Move predefinita è un valore 2D, quindi i vecchi assi Horizontal e Vertical diventano un vettore, non due float. E ReadValue non applica lo smoothing di Gravity e Sensitivity del vecchio sistema, quindi un tasto o un pulsante raggiunge il suo valore completo immediatamente. Se il tuo movimento si basava su quella rampa, dovrai ricrearla appositamente. Input.GetAxisRaw non ha un equivalente diretto. ReadUnprocessedValue() differisce da ReadValue solo quando i processori sono collegati all'azione.
Le letture dirette del dispositivo come Keyboard.current sono un sostituto rapido, non il flusso di lavoro a lungo termine, e il dispositivo corrente può essere null quando quell'hardware è mancante.
Alcune vecchie funzionalità dell'Input Manager dipendono ancora dalla tua versione di Unity. Da Unity 6.4 in poi, le funzioni di evento mouse di MonoBehaviour come OnMouseDown funzionano con l'Input System. Nelle release precedenti di Unity 6 potrebbero non fare nulla una volta che solo il nuovo backend è attivo. Se il tuo progetto usa location, compass o device orientation, controlla la documentazione dell'Input System per il tuo editor prima di disattivare il vecchio manager. IMGUI (OnGUI) non è compatibile con l'Input System, quindi un menu di debug costruito in quel modo potrebbe dover rimanere su Both.
Mantieni funzionante l'interfaccia
Se usi Unity UI (uGUI), hai sempre bisogno di un modulo di input sull'EventSystem per alimentare l'Input System nell'interfaccia. Il vecchio StandaloneInputModule parla ancora al legacy Input Manager. Quando Active Input Handling è impostato solo sul nuovo pacchetto, quel modulo è una fonte frequente dell'eccezione UnityEngine.Input.
Seleziona l'EventSystem nella scena. Se il pacchetto Input System è installato, l'Inspector offre un pulsante che sostituisce StandaloneInputModule con InputSystemUIInputModule. Il nuovo modulo viene preconfigurato con azioni UI predefinite. Quando Active Input Handling è già impostato sul nuovo pacchetto o su Both, Unity aggiunge anche il nuovo modulo automaticamente se posizioni un nuovo elemento uGUI nella scena.
UI Toolkit è diverso. Da Unity 2023.2 in poi, che include Unity 6, UI Toolkit può leggere le azioni UI dalle tue azioni a livello di progetto senza un modulo extra. Hai bisogno di InputSystemUIInputModule più un EventSystem quando UI Toolkit e uGUI condividono la stessa scena.
Se usi anche il componente PlayerInput, assegna lo stesso asset di azioni a PlayerInput e a InputSystemUIInputModule, e imposta il campo UI Input Module su PlayerInput. Quindi la stessa assegnazione del dispositivo guida sia il giocatore che l'interfaccia. Se i tuoi script leggono azioni mentre PlayerInput è in uso, leggi PlayerInput.actions, non InputSystem.actions, perché PlayerInput mantiene una copia filtrata per il dispositivo di ogni giocatore.
L'eccezione e le chiamate Input rimaste
L'errore di runtime di solito recita: 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. Appare quando Active Input Handling è impostato su Input System Package (New) e qualcosa chiama ancora UnityEngine.Input.
Leggi lo stack trace prima di cambiare script a caso. Spesso inizia in StandaloneInputModule o BaseInput.GetButtonDown, non nella tua classe di movimento. Dopo aver corretto l'EventSystem, cerca nel tuo codice Input.GetAxis, Input.GetButton, Input.GetKey, Input.GetMouseButton e Input.mousePosition. Poi controlla asset e plugin di terze parti. Reimpostare Active Input Handling su Both è un passaggio temporaneo valido. La correzione duratura è migrare il chiamante o aggiornare il plugin.
Quando vale la pena usare PlayerInput
Il componente PlayerInput è opzionale. Aggiungilo quando vuoi Send Messages (OnJump, OnMove(InputValue value)), Invoke Unity Events o un PlayerInputManager per multiplayer locale. Un gioco per giocatore singolo che già esegue il polling in Update può rimanere con FindAction e ReadValue.
Una breve checklist di migrazione
- Installa il pacchetto Input System corrente dal Package Manager, poi imposta Active Input Handling su Both.
- Crea o assegna le azioni predefinite a livello di progetto.
- Sostituisci le tue chiamate
Input. Trova ogni azione una volta, poi leggila ogni frame. - Se usi uGUI, sostituisci
StandaloneInputModuleconInputSystemUIInputModulee naviga tra i menu con una tastiera e un gamepad. - Controlla gli eventi
OnMouse, touch, location, compass e IMGUI rispetto alla tua versione di Unity. - Aggiorna i plugin che chiamano ancora
UnityEngine.Input, o lascia Both attivo finché non esiste una correzione. - Quando Play Mode e una build funzionano senza l'eccezione e con un'interfaccia funzionante, imposta Active Input Handling su Input System Package (New).
Prima di fare quest'ultimo passaggio, prova movimento, menu e pulsanti su schermo. L'input è un argomento del motore lato client. horizOn è un backend di gioco con un Unity SDK per account, salvataggio cloud, classifiche e notizie in-game. Migrare l'Input System non cambia il modo in cui usi quell'SDK e non sostituisce o incapsula lo stack di input di Unity.