Terug naar Blog

Hoe je migreert van Unity's oude Input Manager naar het Input System zonder de besturing te breken

Gepubliceerd op 20 november 2026
Hoe je migreert van Unity's oude Input Manager naar het Input System zonder de besturing te breken Gegenereerd met behulp van AI

Kort samengevat

Migreer een Unity 6-project van de oude Input Manager naar het Input System zonder de besturing, UI of overgebleven Input-aanroepen te breken.

Je installeert het Input System, drukt op Play en Unity gooit een foutmelding: je probeert input te lezen met de UnityEngine.Input-klasse, maar Active Input Handling wijst al naar het Input System-pakket. Of Play Mode start en het pauzemenu reageert niet meer op een enkele klik.

Dit artikel toont een veilige volgorde voor het migreren van een bestaand Unity 6-project van de oude Input Manager naar het nieuwe Input System zonder de besturing of UI te breken. Houd beide backends aan, vervang je Input-aanroepen, repareer het EventSystem en schakel de oude manager pas uit wanneer alles nog werkt. De stappen volgen de officiële Input System-documentatie van 20 november 2026. Installeer het huidige Input System-pakket via de Package Manager. Pin geen pakketversie uit dit artikel, want nieuwere releases zullen volgen.

Waarom migreren in Unity 6

Unity's handleiding behandelt de ingebouwde Input Manager nu als een legacy-functie. Het is verouderd, wordt niet aanbevolen voor nieuwe projecten en Unity zegt dat het in een toekomstige versie van de editor zal worden verwijderd. De oude manager blijft beschikbaar zodat bestaande projecten kunnen blijven draaien. Een geplande overstap is nog altijd beter dan wachten tot een toekomstige upgrade de oude backend voor je verwijdert.

Houd beide backends aan tijdens de migratie

Als je project het Input System niet bevat, open dan Window > Package Manager, schakel over naar de Unity Registry en installeer het Input System-pakket. Vanaf Unity 6.1 voegen sommige projectsjablonen het al toe. Lege projecten doen dat vaak niet.

Tijdens de installatie vraagt Unity of je de Input System-backends wilt inschakelen en de Input Manager-backends wilt uitschakelen. Als je Ja kiest, herstart de Editor met alleen het nieuwe systeem actief. Elke overgebleven Input.GetAxis- of Input.GetButton-aanroep faalt dan, en uGUI-menu's die nog de oude input-module gebruiken falen mee.

Stel de backend zelf in. Ga naar Edit > Project Settings > Player, open Other Settings en stel Active Input Handling in op Both. De Editor zal herstarten. In die modus definieert Unity zowel ENABLE_LEGACY_INPUT_MANAGER als ENABLE_INPUT_SYSTEM, zodat oude en nieuwe code naast elkaar kunnen draaien.

#if ENABLE_INPUT_SYSTEM
    // New Input System backends are enabled.
#endif

#if ENABLE_LEGACY_INPUT_MANAGER
    // Old Input Manager backends are enabled.
#endif

Beschouw Both als een brug. Laat het aan tot je eigen scripts, het EventSystem en alle third-party assets zijn overgezet. Schakel pas over naar Input System Package (New) nadat Play Mode en een build werken zonder de foutmelding en met een werkende UI.

Vervang GetAxis en GetButton door Actions

De aanbevolen workflow is om genoemde actions te lezen, niet ruwe apparaatknoppen. Tenzij je meer dan één action-asset nodig hebt, wijs je één enkele asset toe als de projectbrede actions.

Open Edit > Project Settings > Input System Package en maak of wijs de standaard projectbrede actions toe als er geen zijn ingesteld. De standaardwaarden bevatten een Player-map en een UI-map, met actions zoals Move (een Vector2-waarde) en Jump, al gebonden voor toetsenbord, muis, gamepad, touch en XR. Je bereikt ze via InputSystem.actions. Ze zijn standaard ingeschakeld en worden vooraf geladen bij het opstarten, en in de Editor elke keer dat je Play Mode ingaat.

Zoek elke action eenmaal op en lees hem vervolgens elk frame. De action opzoeken op naam elke keer, zoals Input.GetAxis("Horizontal") deed, is het trage pad in de nieuwe 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
        }
    }
}

De namen in de UnityEngine.InputSystem-namespace mappen naar de oude aanroepen zoals dit:

  • Input.GetAxis("Horizontal") en Input.GetAxis("Vertical") worden moveAction.ReadValue<Vector2>()
  • Input.GetButton("Jump") wordt jumpAction.IsPressed()
  • Input.GetButtonDown wordt WasPressedThisFrame()
  • Input.GetButtonUp wordt WasReleasedThisFrame()
  • Input.GetKey(KeyCode.Space) wordt Keyboard.current.spaceKey.isPressed
  • Input.GetMouseButton(0) wordt Mouse.current.leftButton.isPressed
  • Input.mousePosition wordt Mouse.current.position.ReadValue()

Twee details zijn belangrijk als je wilt dat de besturing hetzelfde aanvoelt. De standaard Move-action is een 2D-waarde, dus de oude Horizontal- en Vertical-assen worden één vector, geen twee floats. En ReadValue past de oude Gravity- en Sensitivity-smoothing niet toe, dus een toets of knop bereikt direct zijn volledige waarde. Als je beweging op die oploop vertrouwde, moet je die met opzet opnieuw maken. Input.GetAxisRaw heeft geen directe tegenhanger. ReadUnprocessedValue() verschilt alleen van ReadValue wanneer processors aan de action zijn gekoppeld.

Directe apparaatmetingen zoals Keyboard.current zijn een snelle vervanger, niet de workflow op lange termijn, en het huidige apparaat kan null zijn wanneer die hardware ontbreekt.

Een paar oudere Input Manager-functies hangen nog af van je Unity-versie. Vanaf Unity 6.4 werken MonoBehaviour muisgebeurtenisfuncties zoals OnMouseDown met het Input System. Op eerdere Unity 6-releases doen ze mogelijk niets zodra alleen de nieuwe backend actief is. Als je project location, compass of device orientation gebruikt, raadpleeg dan de Input System-documentatie voor je editor voordat je de oude manager uitschakelt. IMGUI (OnGUI) is niet compatibel met het Input System, dus een debugmenu dat op die manier is gebouwd moet misschien op Both blijven.

Houd de UI werkend

Als je Unity UI (uGUI) gebruikt, heb je altijd een input-module op het EventSystem nodig om het Input System naar de UI te voeren. De oudere StandaloneInputModule praat nog met de legacy Input Manager. Wanneer Active Input Handling is ingesteld op alleen het nieuwe pakket, is die module een veelvoorkomende bron van de UnityEngine.Input-foutmelding.

Selecteer het EventSystem in de scène. Als het Input System-pakket is geïnstalleerd, biedt de Inspector een knop die StandaloneInputModule vervangt door InputSystemUIInputModule. De nieuwe module wordt vooraf geconfigureerd geleverd met standaard UI-actions. Wanneer Active Input Handling al is ingesteld op het nieuwe pakket of op Both, voegt Unity de nieuwe module ook automatisch toe als je een nieuw uGUI-element in de scène plaatst.

UI Toolkit is anders. Vanaf Unity 2023.2, wat Unity 6 omvat, kan UI Toolkit de UI-actions lezen uit je projectbrede actions zonder een extra module. Je hebt wel InputSystemUIInputModule plus een EventSystem nodig wanneer UI Toolkit en uGUI dezelfde scène delen.

Als je ook de PlayerInput-component gebruikt, wijs dan dezelfde action-asset toe aan PlayerInput en aan InputSystemUIInputModule, en stel het UI Input Module-veld in op PlayerInput. Dan drijft dezelfde apparaattoewijzing zowel de speler als de UI aan. Als je scripts actions lezen terwijl PlayerInput in gebruik is, lees dan PlayerInput.actions, niet InputSystem.actions, omdat PlayerInput een gefilterde kopie bijhoudt voor het apparaat van elke speler.

De foutmelding en overgebleven Input-aanroepen

De runtime-fout luidt meestal: 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. Het verschijnt wanneer Active Input Handling is ingesteld op Input System Package (New) en iets nog UnityEngine.Input aanroept.

Lees de stack trace voordat je willekeurige scripts wijzigt. Het begint vaak in StandaloneInputModule of BaseInput.GetButtonDown, niet in je bewegingsklasse. Nadat je het EventSystem hebt gerepareerd, doorzoek je eigen code op Input.GetAxis, Input.GetButton, Input.GetKey, Input.GetMouseButton en Input.mousePosition. Controleer vervolgens third-party assets en plugins. Active Input Handling terug instellen op Both is een geldige tijdelijke stap. De blijvende oplossing is om de aanroeper te migreren of de plugin bij te werken.

Wanneer PlayerInput de moeite waard is

De PlayerInput-component is optioneel. Voeg hem toe wanneer je Send Messages (OnJump, OnMove(InputValue value)), Invoke Unity Events of een PlayerInputManager voor lokale multiplayer wilt. Een single-player game die al in Update pollt, kan bij FindAction en ReadValue blijven.

Een korte migratie-checklist

  1. Installeer het huidige Input System-pakket via de Package Manager en stel vervolgens Active Input Handling in op Both.
  2. Maak of wijs de standaard projectbrede actions toe.
  3. Vervang je eigen Input-aanroepen. Zoek elke action eenmaal op en lees hem vervolgens elk frame.
  4. Als je uGUI gebruikt, vervang StandaloneInputModule door InputSystemUIInputModule en klik door de menu's met een toetsenbord en een gamepad.
  5. Controleer OnMouse-events, touch, location, compass en IMGUI tegen je Unity-versie.
  6. Werk plugins bij die nog UnityEngine.Input aanroepen, of laat Both aan tot een fix bestaat.
  7. Wanneer Play Mode en een build draaien zonder de foutmelding en met een werkende UI, stel Active Input Handling in op Input System Package (New).

Voordat je die laatste schakelaar omzet, speel je door de beweging, menu's en on-screen knoppen. Input is een client-side engine-onderwerp. horizOn is een game-backend met een Unity SDK voor accounts, cloud save, leaderboards en in-game nieuws. Het migreren van het Input System verandert niet hoe je die SDK gebruikt en het vervangt of verpakt Unity's input-stack niet.