블로그로 돌아가기

Unity의 기존 Input Manager에서 Input System으로 컨트롤을 손상시키지 않고 마이그레이션하는 방법

게시일 2026년 11월 20일
Unity의 기존 Input Manager에서 Input System으로 컨트롤을 손상시키지 않고 마이그레이션하는 방법 AI의 도움으로 생성됨

핵심 요약

컨트롤과 UI를 깨지 않고 Unity 6 프로젝트를 Input Manager에서 Input System으로 이전합니다.

Input System을 설치하고 Play를 누르면 Unity가 오류를 발생시킵니다. UnityEngine.Input 클래스로 입력을 읽으려고 하는데 Active Input Handling이 이미 Input System 패키지를 가리키고 있다는 오류입니다. 또는 Play Mode가 시작되는데 일시정지 메뉴가 더 이상 클릭을 받지 못합니다.

이 글에서는 컨트롤이나 UI를 손상시키지 않고 기존 Unity 6 프로젝트를 기존 Input Manager에서 새로운 Input System으로 마이그레이션하는 안전한 순서를 보여줍니다. 두 백엔드를 모두 켜 둔 상태에서 Input 호출을 교체하고, EventSystem을 수정한 다음, 모든 것이 여전히 작동할 때만 기존 매니저를 끕니다. 단계는 2026년 11월 20일 기준 공식 Input System 문서를 따릅니다. Package Manager에서 현재 Input System 패키지를 설치하세요. 최신 릴리스가 출시될 예정이므로 이 글의 패키지 버전을 고정하지 마세요.

Unity 6에서 마이그레이션하는 이유

Unity 매뉴얼은 이제 내장 Input Manager를 레거시 기능으로 취급합니다. 더 이상 사용되지 않으며 새 프로젝트에 권장되지 않으며, Unity는 향후 에디터 버전에서 제거될 것이라고 말합니다. 기존 Input Manager는 기존 프로젝트가 계속 실행될 수 있도록 사용 가능한 상태로 유지됩니다. 계획된 전환은 향후 업그레이드에서 기존 백엔드가 제거될 때까지 기다리는 것보다 낫습니다.

마이그레이션하는 동안 두 백엔드를 모두 켜 두기

프로젝트에 Input System이 포함되어 있지 않다면 Window > Package Manager를 열고 Unity Registry로 전환한 후 Input System 패키지를 설치하세요. Unity 6.1부터 일부 프로젝트 템플릿에는 이미 추가되어 있습니다. 빈 프로젝트에는 종종 포함되지 않습니다.

설치 중에 Unity는 Input System 백엔드를 활성화하고 Input Manager 백엔드를 비활성화할지 묻습니다. Yes를 선택하면 에디터가 새 시스템만 활성화된 상태로 재시작됩니다. 그러면 남아 있는 모든 Input.GetAxis 또는 Input.GetButton 호출이 실패하고, 여전히 기존 input module을 사용하는 uGUI 메뉴도 함께 실패합니다.

대신 백엔드를 직접 설정하세요. Edit > Project Settings > Player로 이동하여 Other Settings를 열고 Active Input Handling을 Both로 설정하세요. 에디터가 재시작됩니다. 이 모드에서 Unity는 ENABLE_LEGACY_INPUT_MANAGER와 ENABLE_INPUT_SYSTEM을 모두 정의하므로 기존 코드와 새 코드가 함께 실행될 수 있습니다.

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

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

Both를 브리지로 취급하세요. 자신의 스크립트, EventSystem 및 타사 에셋이 모두 이전될 때까지 켜 두세요. Play Mode와 빌드가 예외 없이 작동하고 UI가 작동한 후에만 **Input System Package (New)**로 전환하세요.

GetAxis와 GetButton을 Actions로 교체

권장되는 워크플로는 원시 장치 버튼이 아닌 명명된 액션을 읽는 것입니다. 하나 이상의 액션 에셋이 필요하지 않은 한, 단일 에셋을 프로젝트 전체 액션으로 할당하세요.

Edit > Project Settings > Input System Package를 열고 설정되지 않은 경우 기본 프로젝트 전체 액션을 생성하거나 할당하세요. 기본값에는 Player 맵과 UI 맵이 포함되어 있으며, Move(Vector2 값) 및 Jump와 같은 액션이 이미 키보드, 마우스, gamepad, 터치 및 XR에 바인딩되어 있습니다. InputSystem.actions를 통해 액세스할 수 있습니다. 기본적으로 활성화되어 있으며 시작 시 그리고 에디터에서 Play Mode에 들어갈 때마다 미리 로드됩니다.

각 액션을 한 번 찾은 다음 매 프레임마다 읽으세요. Input.GetAxis("Horizontal")이 했던 것처럼 매번 이름으로 액션을 조회하는 것은 새 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
        }
    }
}

UnityEngine.InputSystem 네임스페이스의 이름은 기존 호출에 다음과 같이 매핑됩니다.

  • Input.GetAxis("Horizontal")과 Input.GetAxis("Vertical")은 moveAction.ReadValue<Vector2>()가 됩니다
  • Input.GetButton("Jump")은 jumpAction.IsPressed()가 됩니다
  • Input.GetButtonDown은 WasPressedThisFrame()이 됩니다
  • Input.GetButtonUp은 WasReleasedThisFrame()이 됩니다
  • Input.GetKey(KeyCode.Space)는 Keyboard.current.spaceKey.isPressed가 됩니다
  • Input.GetMouseButton(0)은 Mouse.current.leftButton.isPressed가 됩니다
  • Input.mousePosition은 Mouse.current.position.ReadValue()가 됩니다

컨트롤이 동일하게 느껴지도록 하려면 두 가지 세부 사항이 중요합니다. 기본 Move 액션은 2D 값이므로 기존 Horizontal 및 Vertical 축은 두 개의 float가 아닌 하나의 벡터가 됩니다. 그리고 ReadValue는 기존 Gravity 및 Sensitivity 스무딩을 적용하지 않으므로 키나 버튼이 즉시 전체 값에 도달합니다. 움직임이 해당 램프에 의존했다면 의도적으로 다시 만들어야 합니다. Input.GetAxisRaw는 직접적으로 대응하는 것이 없습니다. ReadUnprocessedValue()는 액션에 프로세서가 연결된 경우에만 ReadValue와 다릅니다.

Keyboard.current와 같은 직접 장치 읽기는 빠른 대체 수단이지 장기적인 워크플로가 아니며, 해당 하드웨어가 없을 때 현재 장치가 null일 수 있습니다.

몇 가지 오래된 Input Manager 기능은 여전히 Unity 버전에 따라 다릅니다. Unity 6.4부터 OnMouseDown과 같은 MonoBehaviour 마우스 이벤트 함수가 Input System과 함께 작동합니다. 이전 Unity 6 릴리스에서는 새 백엔드만 활성화되면 아무 작업도 수행하지 않을 수 있습니다. 프로젝트에서 location, compass 또는 device orientation을 사용하는 경우 기존 매니저를 끄기 전에 에디터에 대한 Input System 문서를 확인하세요. IMGUI(OnGUI)는 Input System과 호환되지 않으므로 그런 방식으로 빌드된 디버그 메뉴는 Both에 머물러야 할 수 있습니다.

UI가 작동하도록 유지

Unity UI(uGUI)를 사용하는 경우 Input System을 UI에 공급하려면 항상 EventSystem에 input module이 필요합니다. 오래된 StandaloneInputModule은 여전히 레거시 Input Manager와 통신합니다. Active Input Handling이 새 패키지로만 설정되면 해당 모듈은 UnityEngine.Input 예외의 빈번한 원인입니다.

씬에서 EventSystem을 선택하세요. Input System 패키지가 설치되어 있으면 Inspector에 StandaloneInputModule을 InputSystemUIInputModule로 교체하는 버튼이 나타납니다. 새 모듈은 기본 UI 액션으로 미리 구성되어 제공됩니다. Active Input Handling이 이미 새 패키지 또는 Both로 설정된 경우, 씬에 새로운 uGUI 요소를 배치할 때 Unity도 자동으로 새 모듈을 추가합니다.

UI Toolkit은 다릅니다. Unity 6을 포함한 Unity 2023.2부터 UI Toolkit은 추가 모듈 없이 프로젝트 전체 액션에서 UI 액션을 읽을 수 있습니다. UI Toolkit과 uGUI가 동일한 씬을 공유할 때는 InputSystemUIInputModule과 EventSystem이 필요합니다.

PlayerInput 컴포넌트도 사용하는 경우 PlayerInput과 InputSystemUIInputModule에 동일한 액션 에셋을 할당하고 PlayerInput의 UI Input Module 필드를 설정하세요. 그러면 동일한 장치 할당이 플레이어와 UI를 모두 구동합니다. PlayerInput을 사용하는 동안 스크립트가 액션을 읽는 경우, PlayerInput은 각 플레이어의 장치에 대해 필터링된 복사본을 유지하므로 InputSystem.actions가 아닌 PlayerInput.actions를 읽으세요.

예외 및 남은 Input 호출

런타임 오류는 일반적으로 다음과 같이 표시됩니다. 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. Active Input Handling이 **Input System Package (New)**로 설정되고 무언가가 여전히 UnityEngine.Input을 호출할 때 나타납니다.

무작위로 스크립트를 변경하기 전에 스택 추적을 읽으세요. 종종 움직임 클래스가 아닌 StandaloneInputModule 또는 BaseInput.GetButtonDown에서 시작됩니다. EventSystem을 수정한 후 자신의 코드에서 Input.GetAxis, Input.GetButton, Input.GetKey, Input.GetMouseButton 및 Input.mousePosition을 검색하세요. 그런 다음 타사 에셋과 플러그인을 확인하세요. Active Input Handling을 Both로 다시 설정하는 것은 유효한 임시 단계입니다. 지속적인 수정은 호출자를 마이그레이션하거나 플러그인을 업데이트하는 것입니다.

PlayerInput이 가치 있는 경우

PlayerInput 컴포넌트는 선택 사항입니다. Send Messages(OnJump, OnMove(InputValue value)), Invoke Unity Events 또는 로컬 멀티플레이어를 위한 PlayerInputManager를 원할 때 추가하세요. 이미 Update에서 폴링하는 싱글 플레이어 게임은 FindAction과 ReadValue를 계속 사용할 수 있습니다.

짧은 마이그레이션 체크리스트

  1. Package Manager에서 현재 Input System 패키지를 설치한 다음 Active Input Handling을 Both로 설정합니다.
  2. 기본 프로젝트 전체 액션을 생성하거나 할당합니다.
  3. 자신의 Input 호출을 교체합니다. 각 액션을 한 번 찾은 다음 매 프레임마다 읽습니다.
  4. uGUI를 사용하는 경우 StandaloneInputModule을 InputSystemUIInputModule로 교체하고 키보드와 gamepad로 메뉴를 클릭해 봅니다.
  5. Unity 버전에 대해 OnMouse 이벤트, 터치, location, compass 및 IMGUI를 확인합니다.
  6. 여전히 UnityEngine.Input을 호출하는 플러그인을 업데이트하거나, 수정 사항이 존재할 때까지 Both를 켜 둡니다.
  7. Play Mode와 빌드가 예외 없이 실행되고 UI가 작동하면 Active Input Handling을 **Input System Package (New)**로 설정합니다.

마지막 스위치를 전환하기 전에 움직임, 메뉴 및 화면 버튼을 플레이해 보세요. Input은 클라이언트 측 엔진 주제입니다. horizOn은 계정, 클라우드 저장, 리더보드 및 게임 내 뉴스를 위한 Unity SDK를 갖춘 게임 백엔드입니다. Input System을 마이그레이션해도 해당 SDK를 사용하는 방법이 변경되지 않으며 Unity의 input 스택을 대체하거나 래핑하지 않습니다.