Retour au Blog

Comment migrer de l'ancien Input Manager de Unity vers l'Input System sans casser les contrôles

Publié le 20 novembre 2026
Comment migrer de l'ancien Input Manager de Unity vers l'Input System sans casser les contrôles Généré avec l'aide de l'IA

En bref

Migrez un projet Unity 6 de l'ancien Input Manager vers le nouvel Input System sans casser les contrôles, l'UI ou les appels Input restants.

Vous installez l'Input System, vous appuyez sur Play, et Unity génère une erreur : vous essayez de lire des entrées avec la classe UnityEngine.Input, mais Active Input Handling pointe déjà vers le package Input System. Ou bien Play Mode démarre, et le menu pause ne reçoit plus un seul clic.

Cet article montre un ordre sûr pour migrer un projet Unity 6 existant de l'ancien Input Manager vers le nouvel Input System sans casser les contrôles ou l'interface utilisateur. Gardez les deux systèmes actifs, remplacez vos appels Input, corrigez l'EventSystem, puis désactivez l'ancien gestionnaire seulement quand tout fonctionne encore. Les étapes suivent la documentation officielle de l'Input System au 20 novembre 2026. Installez le package Input System actuel depuis le Package Manager. Ne fixez pas une version de package à partir de cet article, car de nouvelles versions suivront.

Pourquoi migrer dans Unity 6

Le manuel de Unity traite désormais l'Input Manager intégré comme une fonctionnalité héritée. Il est déprécié, il n'est pas recommandé pour les nouveaux projets, et Unity indique qu'il sera supprimé dans une future version de l'éditeur. L'ancien gestionnaire reste disponible pour que les projets existants puissent continuer à fonctionner. Un changement planifié reste préférable à attendre qu'une future mise à jour supprime l'ancien système pour vous.

Gardez les deux systèmes actifs pendant la migration

Si votre projet n'inclut pas l'Input System, ouvrez Window > Package Manager, passez à Unity Registry, et installez le package Input System. À partir de Unity 6.1, certains modèles de projet l'ajoutent déjà. Les projets vides souvent non.

Pendant l'installation, Unity demande s'il faut activer les systèmes Input System et désactiver les systèmes Input Manager. Si vous choisissez Yes, l'éditeur redémarre avec seulement le nouveau système actif. Chaque appel restant à Input.GetAxis ou Input.GetButton échoue alors, et les menus uGUI qui utilisent encore l'ancien module d'entrée échouent avec eux.

Définissez le système vous-même à la place. Allez dans Edit > Project Settings > Player, ouvrez Other Settings, et définissez Active Input Handling sur Both. L'éditeur va redémarrer. Dans ce mode, Unity définit à la fois ENABLE_LEGACY_INPUT_MANAGER et ENABLE_INPUT_SYSTEM, donc l'ancien et le nouveau code peuvent fonctionner côte à côte.

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

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

Traitez Both comme un pont. Laissez-le activé jusqu'à ce que vos propres scripts, l'EventSystem et tous les assets tiers aient migré. Passez à Input System Package (New) seulement après que Play Mode et un build fonctionnent sans exception et avec une interface utilisateur fonctionnelle.

Remplacez GetAxis et GetButton par des Actions

Le workflow recommandé est de lire des actions nommées, pas des boutons d'appareil bruts. Sauf si vous avez besoin de plus d'un asset d'actions, assignez un seul asset comme actions à l'échelle du projet.

Ouvrez Edit > Project Settings > Input System Package et créez ou assignez les actions par défaut à l'échelle du projet si aucune n'est définie. Les valeurs par défaut incluent une map Player et une map UI, avec des actions comme Move (une valeur Vector2) et Jump, déjà liées pour clavier, souris, gamepad, tactile et XR. Vous y accédez via InputSystem.actions. Elles sont activées par défaut et sont préchargées au démarrage, et dans l'éditeur chaque fois que vous entrez en Play Mode.

Trouvez chaque action une fois, puis lisez-la à chaque frame. Rechercher l'action par nom à chaque fois, comme le faisait Input.GetAxis("Horizontal"), est le chemin lent dans la nouvelle 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
        }
    }
}

Les noms dans l'espace de noms UnityEngine.InputSystem correspondent aux anciens appels comme ceci :

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

Deux détails importent si vous voulez que les contrôles aient la même sensation. L'action Move par défaut est une valeur 2D, donc les anciens axes Horizontal et Vertical deviennent un vecteur, pas deux flottants. Et ReadValue n'applique pas le lissage Gravity et Sensitivity de l'ancien système, donc une touche ou un bouton atteint sa valeur complète immédiatement. Si votre déplacement dépendait de cette rampe, vous devrez la recréer volontairement. Input.GetAxisRaw n'a pas d'équivalent direct. ReadUnprocessedValue() ne diffère de ReadValue que lorsque des processeurs sont attachés à l'action.

Les lectures directes d'appareil comme Keyboard.current sont un substitut rapide, pas le workflow à long terme, et l'appareil actuel peut être null quand ce matériel est absent.

Quelques anciennes fonctionnalités de l'Input Manager dépendent encore de votre version de Unity. À partir de Unity 6.4, les fonctions d'événements souris de MonoBehaviour comme OnMouseDown fonctionnent avec l'Input System. Sur les versions antérieures de Unity 6, elles peuvent ne rien faire une fois que seul le nouveau système est actif. Si votre projet utilise la localisation, la boussole ou l'orientation de l'appareil, consultez la documentation de l'Input System pour votre éditeur avant de désactiver l'ancien gestionnaire. IMGUI (OnGUI) n'est pas compatible avec l'Input System, donc un menu de débogage construit de cette façon peut nécessiter de rester sur Both.

Gardez l'interface utilisateur fonctionnelle

Si vous utilisez Unity UI (uGUI), vous avez toujours besoin d'un module d'entrée sur l'EventSystem pour alimenter l'Input System dans l'interface utilisateur. L'ancien StandaloneInputModule parle encore à l'ancien Input Manager. Quand Active Input Handling est défini uniquement sur le nouveau package, ce module est une source fréquente de l'exception UnityEngine.Input.

Sélectionnez l'EventSystem dans la scène. Si le package Input System est installé, l'Inspector offre un bouton qui remplace StandaloneInputModule par InputSystemUIInputModule. Le nouveau module vient préconfiguré avec des actions UI par défaut. Quand Active Input Handling est déjà défini sur le nouveau package ou sur Both, Unity ajoute aussi le nouveau module automatiquement si vous placez un nouvel élément uGUI dans la scène.

UI Toolkit est différent. À partir de Unity 2023.2, qui inclut Unity 6, UI Toolkit peut lire les actions UI depuis vos actions à l'échelle du projet sans module supplémentaire. Vous avez besoin de InputSystemUIInputModule plus un EventSystem quand UI Toolkit et uGUI partagent la même scène.

Si vous utilisez aussi le composant PlayerInput, assignez le même asset d'actions à PlayerInput et à InputSystemUIInputModule, et définissez le champ UI Input Module sur PlayerInput. Alors la même assignation d'appareil pilote à la fois le joueur et l'interface utilisateur. Si vos scripts lisent des actions pendant que PlayerInput est utilisé, lisez PlayerInput.actions, pas InputSystem.actions, car PlayerInput garde une copie filtrée pour l'appareil de chaque joueur.

L'exception et les appels Input restants

L'erreur d'exécution indique généralement : 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. Elle apparaît quand Active Input Handling est défini sur Input System Package (New) et que quelque chose appelle encore UnityEngine.Input.

Lisez la trace de pile avant de modifier des scripts au hasard. Elle commence souvent dans StandaloneInputModule ou BaseInput.GetButtonDown, pas dans votre classe de déplacement. Après avoir corrigé l'EventSystem, recherchez dans votre propre code Input.GetAxis, Input.GetButton, Input.GetKey, Input.GetMouseButton et Input.mousePosition. Puis vérifiez les assets et plugins tiers. Redéfinir Active Input Handling sur Both est une étape temporaire valide. La correction durable est de migrer l'appelant ou de mettre à jour le plugin.

Quand PlayerInput vaut la peine

Le composant PlayerInput est optionnel. Ajoutez-le quand vous voulez Send Messages (OnJump, OnMove(InputValue value)), Invoke Unity Events, ou un PlayerInputManager pour le multijoueur local. Un jeu solo qui interroge déjà dans Update peut rester avec FindAction et ReadValue.

Une courte checklist de migration

  1. Installez le package Input System actuel depuis le Package Manager, puis définissez Active Input Handling sur Both.
  2. Créez ou assignez les actions par défaut à l'échelle du projet.
  3. Remplacez vos propres appels Input. Trouvez chaque action une fois, puis lisez-la à chaque frame.
  4. Si vous utilisez uGUI, remplacez StandaloneInputModule par InputSystemUIInputModule et cliquez dans les menus avec un clavier et un gamepad.
  5. Vérifiez les événements OnMouse, le tactile, la localisation, la boussole et IMGUI par rapport à votre version de Unity.
  6. Mettez à jour les plugins qui appellent encore UnityEngine.Input, ou laissez Both activé jusqu'à ce qu'une correction existe.
  7. Quand Play Mode et un build fonctionnent sans exception et avec une interface utilisateur fonctionnelle, définissez Active Input Handling sur Input System Package (New).

Avant de basculer ce dernier interrupteur, jouez à travers le déplacement, les menus et les boutons à l'écran. L'entrée est un sujet moteur côté client. horizOn est un backend de jeu avec un SDK Unity pour les comptes, la sauvegarde cloud, les classements et les actualités en jeu. Migrer l'Input System ne change pas la façon dont vous utilisez ce SDK, et il ne remplace ni n'enveloppe la pile d'entrée de Unity.