Voltar ao Blog

Como Migrar do Antigo Input Manager do Unity para o Input System Sem Quebrar os Controles

Publicado em 20 de novembro de 2026
Como Migrar do Antigo Input Manager do Unity para o Input System Sem Quebrar os Controles Gerada com a ajuda de IA

Em resumo

Migre um projeto Unity 6 do antigo Input Manager para o Input System sem quebrar os controles do jogador, a UI ou as chamadas Input restantes.

Você instala o Input System, pressiona Play, e o Unity lança um erro: você está tentando ler input com a classe UnityEngine.Input, mas Active Input Handling já aponta para o pacote Input System. Ou o Play Mode inicia, e o menu de pausa não recebe mais um único clique.

Este artigo mostra uma ordem segura para migrar um projeto Unity 6 existente do antigo Input Manager para o novo Input System sem quebrar controles ou UI. Mantenha ambos os backends ligados, substitua suas chamadas Input, corrija o EventSystem, e então desligue o antigo manager apenas quando tudo ainda funcionar. Os passos seguem a documentação oficial do Input System de 20 de novembro de 2026. Instale o pacote Input System atual do Package Manager. Não fixe uma versão de pacote deste artigo, porque versões mais novas virão.

Por que migrar no Unity 6

O manual do Unity agora trata o Input Manager integrado como um recurso legado. Ele está depreciado, não é recomendado para novos projetos, e o Unity diz que será removido em uma versão futura do editor. O antigo manager permanece disponível para que projetos existentes possam continuar funcionando. Uma mudança planejada ainda é melhor do que esperar até que uma atualização futura remova o antigo backend por você.

Mantenha ambos os backends ligados enquanto você migra

Se seu projeto não inclui o Input System, abra Window > Package Manager, mude para o Unity Registry, e instale o pacote Input System. A partir do Unity 6.1, alguns templates de projeto já o adicionam. Projetos vazios frequentemente não.

Durante a instalação, o Unity pergunta se deve habilitar os backends do Input System e desabilitar os backends do Input Manager. Se você escolher Sim, o Editor reinicia com apenas o novo sistema ativo. Cada chamada Input.GetAxis ou Input.GetButton restante então falha, e menus uGUI que ainda usam o antigo módulo de input falham com eles.

Defina o backend você mesmo em vez disso. Vá para Edit > Project Settings > Player, abra Other Settings, e defina Active Input Handling para Both. O Editor irá reiniciar. Nesse modo, o Unity define tanto ENABLE_LEGACY_INPUT_MANAGER quanto ENABLE_INPUT_SYSTEM, então código antigo e novo podem rodar 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

Trate Both como uma ponte. Deixe ligado até que seus próprios scripts, o EventSystem e quaisquer assets de terceiros tenham migrado. Mude para Input System Package (New) apenas depois que Play Mode e uma build funcionem sem a exceção e com uma UI funcionando.

Substitua GetAxis e GetButton por Actions

O fluxo de trabalho recomendado é ler actions nomeadas, não botões de dispositivo brutos. A menos que você precise de mais de um action asset, atribua um único asset como as actions para todo o projeto.

Abra Edit > Project Settings > Input System Package e crie ou atribua as default project-wide actions se nenhuma estiver definida. Os padrões incluem um mapa Player e um mapa UI, com actions como Move (um valor Vector2) e Jump, já vinculadas para teclado, mouse, gamepad, toque e XR. Você as alcança através de InputSystem.actions. Elas são habilitadas por padrão e são pré-carregadas na inicialização, e no Editor cada vez que você entra em Play Mode.

Encontre cada action uma vez, então leia-a a cada frame. Buscar a action por nome toda vez, como Input.GetAxis("Horizontal") fazia, é o caminho lento na nova 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
        }
    }
}

Os nomes no namespace UnityEngine.InputSystem mapeiam para as chamadas antigas assim:

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

Dois detalhes importam se você quer que os controles sintam o mesmo. A action Move padrão é um valor 2D, então os antigos eixos Horizontal e Vertical se tornam um vetor, não dois floats. E ReadValue não aplica a suavização antiga de Gravity e Sensitivity, então uma tecla ou botão alcança seu valor total imediatamente. Se seu movimento dependia dessa rampa, você precisará recriá-la propositalmente. Input.GetAxisRaw não tem equivalente direto. ReadUnprocessedValue() só difere de ReadValue quando processadores são anexados à action.

Leituras diretas de dispositivo como Keyboard.current são um substituto rápido, não o fluxo de trabalho de longo prazo, e o dispositivo atual pode ser nulo quando esse hardware está ausente.

Alguns recursos mais antigos do Input Manager ainda dependem da sua versão do Unity. A partir do Unity 6.4, funções de evento de mouse do MonoBehaviour como OnMouseDown funcionam com o Input System. Em versões anteriores do Unity 6 elas podem não fazer nada uma vez que apenas o novo backend esteja ativo. Se seu projeto usa localização, bússola ou orientação de dispositivo, verifique a documentação do Input System para seu editor antes de desligar o antigo manager. IMGUI (OnGUI) não é compatível com o Input System, então um menu de debug construído dessa forma pode precisar permanecer em Both.

Mantenha a UI funcionando

Se você usa Unity UI (uGUI), você sempre precisa de um módulo de input no EventSystem para alimentar o Input System na UI. O mais antigo StandaloneInputModule ainda conversa com o legado Input Manager. Quando Active Input Handling está definido para o novo pacote apenas, esse módulo é uma fonte frequente da exceção UnityEngine.Input.

Selecione o EventSystem na cena. Se o pacote Input System está instalado, o Inspector oferece um botão que substitui StandaloneInputModule por InputSystemUIInputModule. O novo módulo vem pré-configurado com UI actions padrão. Quando Active Input Handling já está definido para o novo pacote ou para Both, o Unity também adiciona o novo módulo automaticamente se você colocar um elemento uGUI novo na cena.

UI Toolkit é diferente. A partir do Unity 2023.2, que inclui Unity 6, UI Toolkit pode ler as UI actions de suas project-wide actions sem um módulo extra. Você precisa de InputSystemUIInputModule mais um EventSystem quando UI Toolkit e uGUI compartilham a mesma cena.

Se você também usa o componente PlayerInput, atribua o mesmo action asset ao PlayerInput e ao InputSystemUIInputModule, e defina o campo UI Input Module no PlayerInput. Então a mesma atribuição de dispositivo dirige tanto o jogador quanto a UI. Se seus scripts leem actions enquanto PlayerInput está em uso, leia PlayerInput.actions, não InputSystem.actions, porque PlayerInput mantém uma cópia filtrada para o dispositivo de cada jogador.

A exceção e chamadas Input restantes

O erro de runtime geralmente diz: 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. Ele aparece quando Active Input Handling está definido para Input System Package (New) e algo ainda chama UnityEngine.Input.

Leia o stack trace antes de mudar scripts aleatórios. Ele frequentemente começa em StandaloneInputModule ou BaseInput.GetButtonDown, não na sua classe de movimento. Depois de corrigir o EventSystem, busque em seu próprio código por Input.GetAxis, Input.GetButton, Input.GetKey, Input.GetMouseButton e Input.mousePosition. Então verifique assets e plugins de terceiros. Definir Active Input Handling de volta para Both é um passo temporário válido. A correção duradoura é migrar o caller ou atualizar o plugin.

Quando PlayerInput vale a pena

O componente PlayerInput é opcional. Adicione-o quando você quiser Send Messages (OnJump, OnMove(InputValue value)), Invoke Unity Events, ou um PlayerInputManager para multiplayer local. Um jogo single-player que já faz polling em Update pode permanecer com FindAction e ReadValue.

Uma lista de verificação curta de migração

  1. Instale o pacote Input System atual do Package Manager, então defina Active Input Handling para Both.
  2. Crie ou atribua as default project-wide actions.
  3. Substitua suas próprias chamadas Input. Encontre cada action uma vez, então leia-a a cada frame.
  4. Se você usa uGUI, substitua StandaloneInputModule por InputSystemUIInputModule e clique através dos menus com um teclado e um gamepad.
  5. Verifique eventos OnMouse, toque, localização, bússola e IMGUI contra sua versão do Unity.
  6. Atualize plugins que ainda chamam UnityEngine.Input, ou deixe Both ligado até que uma correção exista.
  7. Quando Play Mode e uma build rodarem sem a exceção e com uma UI funcionando, defina Active Input Handling para Input System Package (New).

Antes de mudar essa última chave, jogue através de movimento, menus e botões na tela. Input é um tópico de engine do lado do cliente. horizOn é um backend de jogo com um SDK Unity para contas, salvamento em nuvem, leaderboards e notícias no jogo. Migrar o Input System não muda como você usa esse SDK, e não substitui ou envolve a pilha de input do Unity.