Cómo migrar del antiguo Input Manager de Unity al Input System sin romper los controles
En resumen
Migra un proyecto de Unity 6 del antiguo Input Manager al Input System sin romper los controles del jugador, la interfaz o las llamadas a Input.
Instalas el Input System, presionas Play y Unity lanza un error: estás intentando leer entrada con la clase UnityEngine.Input, pero Active Input Handling ya apunta al paquete Input System. O empieza el Play Mode y el menú de pausa ya no recibe ni un solo clic.
Este artículo muestra un orden seguro para migrar un proyecto existente de Unity 6 del antiguo Input Manager al nuevo Input System sin romper los controles o la interfaz. Mantén ambos backends activos, reemplaza tus llamadas a Input, corrige el EventSystem y luego apaga el antiguo manager solo cuando todo siga funcionando. Los pasos siguen la documentación oficial del Input System desde el 20 de noviembre de 2026. Instala el paquete actual del Input System desde el Package Manager. No fijes una versión del paquete de este artículo, porque habrá versiones más nuevas.
Por qué migrar en Unity 6
El manual de Unity ahora trata al Input Manager integrado como una característica heredada. Está deprecado, no se recomienda para proyectos nuevos y Unity dice que será eliminado en una futura versión del editor. El antiguo manager sigue disponible para que los proyectos existentes puedan seguir funcionando. Un cambio planificado es mejor que esperar hasta que una futura actualización elimine el antiguo backend por ti.
Mantén ambos backends activos mientras migras
Si tu proyecto no incluye el Input System, abre Window > Package Manager, cambia a Unity Registry e instala el paquete Input System. Desde Unity 6.1 en adelante, algunas plantillas de proyecto ya lo agregan. Los proyectos vacíos a menudo no lo tienen.
Durante la instalación, Unity pregunta si deseas habilitar los backends del Input System y deshabilitar los backends del Input Manager. Si eliges Yes, el Editor se reinicia con solo el nuevo sistema activo. Cada llamada restante a Input.GetAxis o Input.GetButton entonces falla, y los menús uGUI que todavía usan el antiguo módulo de entrada fallan con ellos.
Configura el backend tú mismo en su lugar. Ve a Edit > Project Settings > Player, abre Other Settings y establece Active Input Handling en Both. El Editor se reiniciará. En ese modo, Unity define tanto ENABLE_LEGACY_INPUT_MANAGER como ENABLE_INPUT_SYSTEM, así que el código antiguo y nuevo pueden ejecutarse lado a lado.
#if ENABLE_INPUT_SYSTEM
// New Input System backends are enabled.
#endif
#if ENABLE_LEGACY_INPUT_MANAGER
// Old Input Manager backends are enabled.
#endif
Trata a Both como un puente. Déjalo activo hasta que tus propios scripts, el EventSystem y cualquier asset de terceros se hayan cambiado. Cambia a Input System Package (New) solo después de que el Play Mode y una build funcionen sin la excepción y con una interfaz funcional.
Reemplaza GetAxis y GetButton con Actions
El flujo de trabajo recomendado es leer acciones con nombre, no botones de dispositivo sin procesar. A menos que necesites más de un action asset, asigna un solo asset como las acciones globales del proyecto.
Abre Edit > Project Settings > Input System Package y crea o asigna las acciones globales predeterminadas del proyecto si no hay ninguna configurada. Las predeterminadas incluyen un mapa Player y un mapa UI, con acciones como Move (un valor Vector2) y Jump, ya vinculadas para teclado, mouse, gamepad, táctil y XR. Las alcanzas a través de InputSystem.actions. Están habilitadas por defecto y se precargan al inicio, y en el Editor cada vez que entras al Play Mode.
Encuentra cada acción una vez, luego léela en cada frame. Buscar la acción por nombre cada vez, como hacía Input.GetAxis("Horizontal"), es el camino lento en la nueva 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
}
}
}
Los nombres en el namespace UnityEngine.InputSystem se mapean a las antiguas llamadas así:
Input.GetAxis("Horizontal")eInput.GetAxis("Vertical")se convierten enmoveAction.ReadValue<Vector2>()Input.GetButton("Jump")se convierte enjumpAction.IsPressed()Input.GetButtonDownse convierte enWasPressedThisFrame()Input.GetButtonUpse convierte enWasReleasedThisFrame()Input.GetKey(KeyCode.Space)se convierte enKeyboard.current.spaceKey.isPressedInput.GetMouseButton(0)se convierte enMouse.current.leftButton.isPressedInput.mousePositionse convierte enMouse.current.position.ReadValue()
Dos detalles importan si quieres que los controles se sientan igual. La acción Move predeterminada es un valor 2D, así que los antiguos ejes Horizontal y Vertical se convierten en un vector, no dos floats. Y ReadValue no aplica el suavizado de Gravity y Sensitivity del antiguo sistema, así que una tecla o botón alcanza su valor completo inmediatamente. Si tu movimiento dependía de esa rampa, necesitarás recrearla a propósito. Input.GetAxisRaw no tiene un equivalente directo. ReadUnprocessedValue() solo difiere de ReadValue cuando hay procesadores adjuntos a la acción.
Las lecturas directas de dispositivo como Keyboard.current son un reemplazo rápido, no el flujo de trabajo a largo plazo, y el dispositivo actual puede ser null cuando ese hardware falta.
Algunas características antiguas del Input Manager todavía dependen de tu versión de Unity. Desde Unity 6.4 en adelante, las funciones de eventos del mouse de MonoBehaviour como OnMouseDown funcionan con el Input System. En versiones anteriores de Unity 6 pueden no hacer nada una vez que solo el nuevo backend esté activo. Si tu proyecto usa location, compass o device orientation, revisa la documentación del Input System para tu editor antes de apagar el antiguo manager. IMGUI (OnGUI) no es compatible con el Input System, así que un menú de depuración construido de esa manera puede necesitar quedarse en Both.
Mantén la interfaz funcionando
Si usas Unity UI (uGUI), siempre necesitas un módulo de entrada en el EventSystem para alimentar el Input System a la interfaz. El antiguo StandaloneInputModule todavía se comunica con el antiguo Input Manager. Cuando Active Input Handling está configurado solo al nuevo paquete, ese módulo es una fuente frecuente de la excepción UnityEngine.Input.
Selecciona el EventSystem en la escena. Si el paquete Input System está instalado, el Inspector ofrece un botón que reemplaza StandaloneInputModule con InputSystemUIInputModule. El nuevo módulo viene preconfigurado con acciones de UI predeterminadas. Cuando Active Input Handling ya está configurado al nuevo paquete o a Both, Unity también agrega el nuevo módulo automáticamente si colocas un elemento uGUI nuevo en la escena.
UI Toolkit es diferente. Desde Unity 2023.2 en adelante, que incluye Unity 6, UI Toolkit puede leer las acciones de UI de tus acciones globales del proyecto sin un módulo extra. Sí necesitas InputSystemUIInputModule más un EventSystem cuando UI Toolkit y uGUI comparten la misma escena.
Si también usas el componente PlayerInput, asigna el mismo action asset a PlayerInput y a InputSystemUIInputModule, y configura el campo UI Input Module en PlayerInput. Entonces la misma asignación de dispositivo controla tanto al jugador como a la interfaz. Si tus scripts leen acciones mientras PlayerInput está en uso, lee PlayerInput.actions, no InputSystem.actions, porque PlayerInput mantiene una copia filtrada para el dispositivo de cada jugador.
La excepción y las llamadas restantes a Input
El error de tiempo de ejecución generalmente dice: 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. Aparece cuando Active Input Handling está configurado a Input System Package (New) y algo todavía llama a UnityEngine.Input.
Lee el stack trace antes de cambiar scripts al azar. A menudo comienza en StandaloneInputModule o BaseInput.GetButtonDown, no en tu clase de movimiento. Después de corregir el EventSystem, busca en tu propio código Input.GetAxis, Input.GetButton, Input.GetKey, Input.GetMouseButton e Input.mousePosition. Luego revisa los assets y plugins de terceros. Configurar Active Input Handling de vuelta a Both es un paso temporal válido. La solución duradera es migrar el código que llama o actualizar el plugin.
Cuándo vale la pena PlayerInput
El componente PlayerInput es opcional. Agrégalo cuando quieras Send Messages (OnJump, OnMove(InputValue value)), Invoke Unity Events o un PlayerInputManager para multijugador local. Un juego de un solo jugador que ya hace polling en Update puede quedarse con FindAction y ReadValue.
Una lista de verificación corta de migración
- Instala el paquete actual del Input System desde el Package Manager, luego configura Active Input Handling a Both.
- Crea o asigna las acciones globales predeterminadas del proyecto.
- Reemplaza tus propias llamadas a
Input. Encuentra cada acción una vez, luego léela en cada frame. - Si usas uGUI, reemplaza
StandaloneInputModuleconInputSystemUIInputModuley haz clic a través de los menús con un teclado y un gamepad. - Revisa los eventos
OnMouse, táctil, location, compass e IMGUI contra tu versión de Unity. - Actualiza los plugins que todavía llaman a
UnityEngine.Input, o deja Both activo hasta que exista una solución. - Cuando el Play Mode y una build se ejecuten sin la excepción y con una interfaz funcional, configura Active Input Handling a Input System Package (New).
Antes de que cambies ese último interruptor, juega a través del movimiento, los menús y los botones en pantalla. Input es un tema del motor del lado del cliente. horizOn es un backend de juego con un SDK de Unity para cuentas, guardado en la nube, tablas de clasificación y noticias en el juego. Migrar el Input System no cambia cómo usas ese SDK, y no reemplaza ni envuelve el stack de entrada de Unity.