Input System과 입력 Action

키보드 조작을 코드에서 읽으려면 입력을 처리할 기능이 필요합니다. 먼저 Input System 패키지를 설치합니다. 지금은 어떤 키가 이동을 맡을지 정하기 전입니다.

1. Package Manager에서 Input System 설치

   패키지는 특정 기능의 코드·설정·도구를 묶어 배포하는 단위입니다. Package Manager는 열려 있는 프로젝트에서 사용할 기능을 관리합니다. Unity Hub에서 Editor를 설치하는 것과는 다른 작업입니다.

   Window → Package Management → Package Manager를 엽니다. 왼쪽에서 Unity Registry를 선택하고 검색창에 Input System을 입력합니다. 검색 결과의 Input System을 클릭해 상세 정보를 엽니다. Install 버튼이 있으면 클릭하고 설치가 끝날 때까지 기다립니다. 이미 설치되어 있다면 버전과 설치 상태만 확인합니다.

   목록에 이름이 보이는 것은 검색 결과이고, Installed가 표시되어야 설치된 상태입니다. GameEngine1에 설치해도 다른 프로젝트에 자동으로 추가되지는 않습니다.

   새 입력 기능을 활성화하고 Editor를 재시작할지 묻는 안내가 나오면 Yes를 선택합니다. 재시작 전 Scene 저장 요청이 나오면 저장합니다.

   결과Package Manager에 Input System이 Installed로 표시됩니다. Unity 6.6 기준 릴리스 버전은 1.20.0입니다.

2. 입력 처리 방식 선택과 재시작

   패키지 설치는 기능을 추가하는 일이고, Active Input Handling은 사용할 입력 처리 방식을 정하는 설정입니다. New는 새 Input System, Old는 기존 Input Manager, Both는 두 방식의 사용을 뜻합니다.

   Edit → Project Settings → Player → Other Settings에서 Active Input Handling을 찾습니다. Input System Package (New) 또는 Both이면 이번 입력 예제를 실행할 수 있습니다. Input Manager (Old)로 설정되어 있으면 Input System의 입력 처리가 활성화되지 않습니다. 이 항목을 바꾸면 Editor를 재시작해야 적용됩니다.

   완료 기준새 Input System이 활성화되어 Action 에셋을 만들 수 있습니다.

3. 재시작 뒤 작업 Scene으로 돌아오기

   Editor가 다시 열리면 Hierarchy의 Scene 이름이 Week04_InputPhysics인지 확인합니다. 다른 Scene이 열렸다면 Project의 Assets/Scenes에서 해당 Scene을 더블클릭합니다. Package Manager와 Project Settings 창을 닫고 Project의 Assets를 선택합니다.

   다음 작업 위치Play 모드는 종료되어 있고, Project에서 입력 설정 에셋을 만들 준비가 되었습니다.

공식 설치 안내 ↗에서 설치와 입력 활성화 절차를 확인할 수 있습니다.

다음 단계: PlayerControls 에셋을 만들며 Action Map과 Move를 설정합니다.

이제 설정 파일 → 행동 묶음 → 이동 행동 → 값의 형태 순서로 만듭니다. 화면에서 각 항목을 추가할 때 그 항목이 필요한 이유를 함께 확인합니다.

1. Input Actions 에셋 생성

   설치한 패키지는 입력 기능을 제공하고, Input Actions 에셋은 이 게임의 조작 설정을 저장하는 파일입니다. Project의 Assets에서 우클릭한 뒤 Create → Input Actions를 선택합니다. 이름을 PlayerControls로 입력하고 Enter로 확정합니다. 파일을 더블클릭하면 Action 편집 창이 열립니다. 이미 같은 에셋이 있다면 그 파일을 엽니다.

   결과Project에 PlayerControls.inputactions가 생깁니다.

2. 왼쪽에서 Player 맵 추가

   Action Map은 함께 활성화하거나 비활성화할 수 있는 Action의 묶음입니다. 왼쪽에 Player 맵이 있으면 그 행을 선택합니다. 없다면 Action Maps 제목 옆 +를 클릭합니다. 새 맵의 이름을 Player로 입력하고 Enter로 확정한 뒤, 그 행을 선택합니다. 이름을 다시 바꾸려면 해당 행을 우클릭해 Rename을 선택합니다.

   이 Player는 행동을 묶는 맵 이름이며 Hierarchy의 캐릭터가 아닙니다. 같은 이름이라고 자동으로 연결되지 않습니다. 나중에 스크립트의 참조로 둘을 연결합니다. Player 맵에는 Move와 Jump를, UI 맵에는 Navigate와 Submit을 묶을 수 있습니다.

   결과왼쪽에 Player 맵이 보입니다.

3. 가운데에서 Move Action 추가

   Action은 게임이 이해하는 행동 이름입니다. 왼쪽 Player가 선택된 상태에서 가운데 Actions를 봅니다. Action이 없다면 Actions 제목 옆 +를 클릭하고 이름을 Move로 입력한 뒤 Enter로 확정합니다. 기본 Action이 이미 생겼다면 그 행을 우클릭해 Rename으로 이름만 바꿉니다. 이미 Move가 있다면 그대로 선택합니다. Move는 키 이름이 아니라 플레이어가 이동하려 한다는 뜻입니다.

   아직 D나 화살표를 지정하지 않았습니다. 먼저 게임에서 사용할 행동을 정하고 다음 단계에서 키를 연결합니다. 이렇게 하면 코드는 같은 Move를 읽으면서 조작 키만 바꿀 수 있습니다.

   결과Player 아래에 Move가 보입니다.

4. Move를 선택하고 Value / Vector2 설정

   Vector2는 숫자 두 개를 한 쌍으로 묶은 값입니다. 첫 숫자 x는 가로, 둘째 숫자 y는 세로입니다. 오른쪽 입력은 x의 양수 값으로, 위쪽 입력은 y의 양수 값으로 표현합니다.

   Move 이름이 적힌 행을 클릭합니다. 왼쪽 삼각형은 펼침 버튼이므로 이름 부분을 선택합니다. 오른쪽 Action Properties에서 먼저 Action Type = Value, 이어서 Control Type = Vector2를 선택합니다. Action Type은 입력 처리 방식을, Control Type은 기대하는 값의 형태를 정합니다.

   점프나 확인처럼 버튼의 눌림을 사용할 행동에는 보통 Button을 씁니다. Button도 누르고 있는 상태를 확인할 수 있으므로, “계속 누르면 Value, 한 번 누르면 Button”으로 구분하지 않습니다. 지금은 방향 값을 읽기 위해 Value / Vector2를 선택합니다.

   오른쪽에 Path나 Composite Type만 보이면 Binding을 선택한 상태입니다. 가운데 Move 이름 행을 다시 클릭합니다.

   완료 기준Move가 Value / Vector2입니다. 아직 키는 연결하지 않았습니다.

입력 없음

x = 0, y = 0
두 계기 모두 중앙

D키 입력

x = 1, y = 0
가로 계기만 오른쪽

W키 입력

x = 0, y = 1
세로 계기만 위쪽

가로 계기는 x, 세로 계기는 y입니다. 중앙 눈금은 0이며, 세 장면의 캐릭터는 모두 같은 자리에 있습니다.

Move의 이름만으로 캐릭터가 움직이지는 않습니다. 지금 만든 것은 이동 의도를 전달할 Action입니다. 어떤 키가 어떤 방향을 만드는지는 다음 Binding 설정에서 정합니다. Actions 공식 문서와 Action Types 공식 문서에서 두 설정의 역할을 확인할 수 있습니다.

다음 단계: 키를 연결하며 Binding과 Composite를 확인합니다.

Move에 어떤 조작을 전달할지 정할 차례입니다. 키를 연결할 때 장치·조작부·연결 규칙의 차이를 함께 봅니다.

1. Move 아래에 WASD Composite 추가

   Move에는 가로·세로 두 숫자가 필요하지만 키 하나는 눌림과 해제를 전달합니다. 2D Vector Composite는 네 방향의 키를 하나의 Vector2로 합칩니다. 그래서 Action 네 개 대신 한 Move 아래에 네 방향 묶음을 추가합니다.

   가운데 Move 행 오른쪽의 +를 클릭해 Add Up/Down/Left/Right Composite를 선택합니다. Actions 제목 옆의 +는 새 Action을 만드는 버튼입니다. Move 아래 생긴 Composite 묶음을 펼치고, 묶음 이름 행을 우클릭해 Rename으로 WASD라고 지정합니다.

   WASD 부모 행을 선택해 오른쪽 Composite Type이 2D Vector인지 확인합니다. Mode는 기본값 Digital Normalized 그대로 둡니다. 아래 Up·Down·Left·Right는 이 묶음에 속한 네 방향입니다.

   결과Up, Down, Left, Right 네 칸이 하나의 묶음으로 나타납니다.

2. Up 한 칸에 W 연결

   Binding은 조작부를 Action에 연결하는 규칙입니다. 여기서는 W를 위 방향 역할에 연결합니다. Path의 <Keyboard>/w에서 Keyboard는 장치(Device), w는 장치 안의 조작부(Control)입니다. 파일 경로가 아닙니다.

   가운데 WASD 아래의 Up 행을 클릭합니다. 오른쪽 Binding Properties의 Path 드롭다운을 열고 Listen을 클릭한 뒤 W를 눌렀다 놓습니다. 감지된 W [Keyboard] 항목을 선택해 확정합니다. Path는 <Keyboard>/w에 해당합니다.

   키를 누르기만 하고 창을 닫으면 선택이 완료되지 않을 수 있습니다. 가운데 Up 행에 W [Keyboard]가 표시되는지 확인합니다. 오른쪽에 Mode만 보이면 부모 WASD를 선택한 것이므로 Up을 다시 클릭합니다. Listen은 Binding Path를 선택하는 도구이며 Move의 현재 숫자를 표시하지 않습니다.

   중간 확인Up: W [Keyboard]가 보입니다. 이 한 칸을 확인한 뒤 나머지 키를 연결합니다.

3. Down·Left·Right도 각각 연결

   Move의 x는 가로, y는 세로 입력입니다. Right는 양수 x, Left는 음수 x, Up은 양수 y, Down은 음수 y를 만듭니다. 어느 키를 어느 방향에 연결하는지가 출력의 부호를 정합니다.

   Down 행을 선택해 Path → Listen → S → 감지된 항목 선택을 반복합니다. 이어서 Left에는 A, Right에는 D를 연결합니다. 매번 가운데에서 수정할 행을 먼저 선택합니다. 같은 Up 행의 Path를 네 번 바꾸는 작업이 아닙니다.

   확인WASD 아래 네 행이 위에서부터 W, S, A, D로 보입니다. 새 Action 네 개를 만들지 않습니다.

4. 설정 저장 후 다시 열어 확인

   창 오른쪽 위 Save Asset을 클릭합니다. 창을 닫고 Project의 PlayerControls를 다시 더블클릭합니다. Player → Move → WASD를 펼쳐 네 키가 남아 있는지 확인합니다. 방향키는 WASD 입력값을 확인한 뒤에 추가합니다.

   완료 기준Move 아래에 WASD 한 묶음이 저장되어 있고, 네 방향의 키 배치가 아래 표와 일치합니다.

Move 행을 선택하면 값의 형식, WASD 부모 행을 선택하면 네 방향을 합치는 방식, Up 같은 자식 행을 선택하면 키 경로가 보입니다. Action과 Binding은 선택하는 행부터 다릅니다. 이번에는 Processors를 추가하지 않고 Mode는 Digital Normalized로 유지합니다.

방금 연결한 네 역할을 짚어 봅니다

Device, Control, Binding, Action은 지금 설정한 경로의 각 역할입니다. 키보드 → D키 → WASD의 Right 연결 → Move 순서로 화면의 항목을 가리켜 봅니다.

그림으로 다시 보기 · 키 연결과 Action

Move ActionDevice · 키보드Device · 게임패드BindingControl · 키Control · 스틱

Device와 Control

키보드 전체는 장치입니다. 개별 키와 게임패드의 스틱은 그 안의 조작부입니다.

Binding과 Action

케이블은 연결 규칙의 비유입니다. 두 장치 모두 같은 Move Action에 입력을 전달합니다.

설정 창 참고 · 방향키까지 추가한 완성 예시

다음 단계: 방금 만든 Move를 읽고 표시하는 코드를 연결합니다.

입력 설정만으로는 Game 화면에 숫자가 나타나지 않습니다. InputValueDisplay가 Move를 참조하고 활성화한 뒤, 현재 값을 읽어 rawValue에 저장하고 화면에 표시합니다. 위치나 속도를 바꾸는 코드는 넣지 않습니다.

3주차의 필드·메서드·Update를 사용합니다. 전체 코드를 연결한 뒤 대상 지정 → 활성화 → 읽기 → 표시가 어느 줄인지 짚고 첫 실행으로 넘어갑니다.

1. 스크립트 파일 생성

   Project의 Assets/Scripts를 선택합니다. 폴더가 없으면 Assets에서 우클릭해 Create → Folder로 Scripts를 만듭니다. 폴더 안에서 우클릭해 Create → Scripting → MonoBehaviour Script를 선택하고 이름을 InputValueDisplay로 입력한 뒤 Enter로 확정합니다. 버전에 따라 C# Script로 보일 수 있습니다. 파일 이름과 클래스 이름을 대소문자까지 일치시킵니다. 같은 파일이 있다면 새로 만들지 않고 엽니다.

   결과InputValueDisplay.cs가 생깁니다.

2. 기본 내용을 아래 완성 코드로 교체

   InputValueDisplay.cs를 더블클릭합니다. 편집기 탭 이름이 InputValueDisplay.cs인지 확인한 뒤 아래 코드의 복사 버튼을 클릭합니다. 편집기로 돌아가 Ctrl+A → Ctrl+V → Ctrl+S로 전체를 교체하고 저장합니다. macOS에서는 Ctrl 대신 Cmd를 사용합니다. 기존 MotionController 파일은 수정하지 않습니다.

   확인파일 첫 줄이 using UnityEngine;이고 클래스 이름은 InputValueDisplay입니다. 기존 클래스 아래에 새 코드를 덧붙이지 않습니다.

3. Unity로 돌아와 컴파일 확인

   Unity 창을 클릭하고 컴파일이 끝날 때까지 기다립니다. Window → General → Console을 열어 빨간 오류가 0개인지 확인합니다. 오류가 있으면 첫 빨간 항목을 선택해 파일 이름과 내용을 읽습니다. 파일·클래스 이름, 붙여넣은 코드의 누락, Input System 설치를 확인한 뒤 다시 저장합니다.

   다음 단계 조건오류가 0개이면 Hierarchy의 Player에 스크립트를 추가할 수 있습니다. 아직 Play를 시작하지 않습니다.

using UnityEngine;
using UnityEngine.InputSystem;

public class InputValueDisplay : MonoBehaviour
{
    [SerializeField] private InputActionReference moveAction;

    [SerializeField] private Vector2 rawValue;

    private void OnEnable()
    {
        if (moveAction == null)
        {
            Debug.LogError("InputValueDisplay: Move Action을 연결하세요.", this);
            enabled = false;
            return;
        }

        moveAction.action.Enable();
    }

    private void OnDisable()
    {
        if (moveAction != null)
        {
            moveAction.action.Disable();
        }
    }

    private void Update()
    {
        rawValue = moveAction.action.ReadValue<Vector2>();
    }

    private void OnGUI()
    {
        GUI.Box(new Rect(12f, 12f, 260f, 40f), "raw " + rawValue);
    }
}

방금 넣은 코드를 실행 순서로 읽습니다

• using UnityEngine.InputSystem;InputActionReference와 Action API를 쓰기 위한 선언입니다. 이 예제는 이 네임스페이스를 가져와 자료형 이름을 짧게 씁니다.
• InputActionReference moveActionInspector에서 에셋 속 Move의 참조를 지정하는 필드입니다. 키 이름을 코드에 적지 않습니다.
• OnEnable / OnDisableAction은 활성 상태에서 입력을 처리합니다. 컴포넌트가 활성화될 때 Enable을 호출하고, 비활성화될 때 Disable을 호출합니다. 비활성 Action의 ReadValue는 (0, 0)입니다.
• ReadValue<Vector2>()Move Action이 지금 만든 값을 읽습니다. 이 코드는 장치를 직접 구분하지 않고 Move의 현재 값을 읽습니다. 곧 실행할 화면에서 raw로 표시될 두 숫자입니다.
• OnGUIGame 화면에 숫자를 표시합니다. 오브젝트를 움직이지 않습니다. Inspector의 rawValue도 Play 중에 같은 값을 보여 줍니다.

moveAction은 읽을 대상의 참조이고, rawValue는 읽은 결과를 저장하는 값입니다. [SerializeField]로 Inspector에 표시한 Move Action 슬롯에 다음 단계에서 실제 Move를 연결합니다. 필드를 선언하는 것만으로 에셋이 연결되지는 않습니다.

rawValue = moveAction.action.ReadValue<Vector2>();는 오른쪽 메서드를 호출해 반환된 두 숫자를 왼쪽 필드에 저장합니다. <Vector2>는 Move의 Control Type과 맞는 값 형식입니다. Update에서 매 프레임 이 줄을 실행하므로 입력이 바뀌면 저장된 값도 갱신됩니다.

에셋을 저장하는 것과 Action을 활성화하는 것은 다릅니다. 이 코드의 OnEnable()은 컴포넌트가 활성화될 때 Enable()을 호출하고, OnDisable()은 꺼질 때 Disable()을 호출합니다. Start와 달리 OnEnable은 컴포넌트를 다시 켤 때도 호출됩니다.

다음 단계: Player에 컴포넌트를 추가하고 Move Action 슬롯에 읽을 대상을 지정합니다.

코드가 완성되었어도 어느 오브젝트에서 실행할지, 어느 Action을 읽을지를 정해야 합니다. Player에 컴포넌트를 추가하고 Move를 연결합니다.

1. 기존 스프라이트 캐릭터 선택

   Hierarchy에서 2주차에 Sprite Renderer와 캐릭터 이미지를 연결한 Player를 선택합니다. Player의 Sprite와 자식 DirectionMarker는 그대로 사용합니다. 여기에 3주차 MotionController가 있다면 컴포넌트 제목 왼쪽 체크박스의 선택을 해제하고, 자동 이동·회전을 담당하는 다른 스크립트 컴포넌트도 비활성화합니다. Player 오브젝트 자체는 활성 상태로 유지합니다.

   결과기존 캐릭터가 보이고 자동 움직임만 멈춘 상태입니다.

2. Player에 입력값 표시 스크립트 추가

   Hierarchy에서 Player가 선택되어 Inspector 맨 위에 Player 이름이 보이는지 확인합니다. Project의 InputValueDisplay.cs를 Player의 Inspector 빈 영역으로 드래그합니다. 추가된 Input Value Display 컴포넌트의 체크박스가 켜져 있어야 합니다. 이미 같은 컴포넌트가 있으면 다시 추가하지 않습니다.

   Inspector에 코드 내용만 보인다면 Project의 스크립트 파일을 선택한 상태입니다. Hierarchy의 Player를 다시 선택합니다. Player에는 입력값 표시 컴포넌트 하나만 사용합니다.

   결과Player의 Sprite Renderer와 InputValueDisplay가 함께 있고, InputValueDisplay에 Move Action 슬롯이 보입니다.

3. Move Action 슬롯에 에셋 속 Move 연결

   이 슬롯은 코드의 InputActionReference moveAction 필드입니다. 스크립트가 읽을 Action을 지정하는 참조이므로 에셋 속 Move를 선택합니다. Input Actions의 Player 맵과 Hierarchy의 Player가 같은 이름이어도 이 연결을 대신해 주지 않습니다.

   Input Value Display 컴포넌트 안의 Move Action 슬롯 오른쪽 원형 선택 버튼을 클릭합니다. 선택 창에서 Move를 검색하고 PlayerControls / Player / Move에 해당하는 항목을 선택합니다. 또는 Project에서 PlayerControls.inputactions를 펼쳐 하위 Move를 이 슬롯으로 드래그합니다. 에셋 파일 전체나 Hierarchy의 Player를 넣는 칸이 아닙니다.

   선택 창을 닫은 뒤 Move Action이 None이 아닌지 확인합니다. 목록에 Move가 없으면 Action 편집 창에서 Save Asset을 클릭하고 Unity의 갱신이 끝난 뒤 선택 창을 다시 엽니다. 칸이 None이면 Play 시 Console에 오류가 나고 컴포넌트가 비활성화됩니다.

   완료 기준Move Action 칸에 Player/Move가 표시됩니다.

참조와 읽은 값은 다른 정보입니다

Move Action 슬롯은 읽을 대상이고 rawValue는 그 대상에서 읽어 저장한 두 숫자입니다. 지금 연결을 마친 뒤 Play하면 OnEnable이 Move를 활성화하고 Update가 현재 값을 읽습니다. None은 읽을 대상이 없는 상태이며 입력값 (0, 0)과 다릅니다.

그림으로 다시 보기 · Move 참조와 rawValue

입력 에셋Move Action참조컴포넌트rawValue

참조 · 읽을 대상 지정

컴포넌트의 moveAction은 에셋 안의 기존 Move Action을 가리킵니다. Action 자체를 복사하지 않습니다.

값 · 읽은 결과 저장

컴포넌트 내부의 rawValue에 x와 y를 저장합니다. 서랍의 두 타일은 이 두 값을 나타냅니다.

Ctrl+S로 Scene을 저장합니다. 1교시에는 기존 Player·DirectionMarker·Background를 사용하고 입력값만 표시합니다. 2교시에는 같은 캐릭터를 유지하고 기존 Background를 비활성화한 뒤 Ground.png로 바닥을 준비합니다.

다음 단계: 방금 연결한 코드가 무엇을 보여 줄지 예측한 뒤 처음으로 Play합니다.

실행 01 · 숫자는 바뀌는데 캐릭터는 왜 그대로일까요?

실행 전 질문: D를 눌렀을 때 (1, 0)이 보이면 캐릭터가 오른쪽으로 한 칸 이동했다는 뜻일까요? 화면의 숫자와 캐릭터 위치를 따로 봅니다.

1. 방금 코드를 연결한 장면 실행

   Move 참조까지 연결한 Scene에서 Play를 시작하고 Game 화면 안쪽을 클릭합니다. 모든 키에서 손을 뗀 상태로 raw 상자와 캐릭터를 함께 봅니다.

   관찰raw는 (0, 0)이고 캐릭터는 정지해 있습니다.

2. D를 누른 뒤 손을 떼기

   D만 누르면 raw가 바뀝니다. 캐릭터의 위치도 바뀌는지 비교합니다. D에서 손을 떼면 숫자가 어떻게 돌아오는지 보고 Play를 종료합니다.

   관찰raw는 (1, 0)이 되지만 위치는 그대로입니다. 손을 떼면 다시 (0, 0)입니다.

결과 해석: 지금 확인한 것은 입력 연결이 작동한다는 사실입니다. Move의 1은 오른쪽 조작의 값이며 거리 1이나 초당 속도 1을 뜻하지 않습니다. 방금 읽은 InputValueDisplay의 실행 순서로 돌아가면 Update는 값을 저장하고 OnGUI는 표시합니다. 위치를 바꾸는 명령이 없으므로 캐릭터가 정지해 있는 것이 정상입니다.

나중에 같은 입력 1에 이동 속도 5를 적용할 수 있지만, 그 계산은 이동 코드의 역할입니다. 이동 속도를 바꿔도 Move의 입력값은 그대로일 수 있습니다. 반대로 입력값이 1이어도 벽에 막히면 위치가 바뀌지 않을 수 있습니다. 입력값, 이동 규칙, 실제 움직임을 구분해야 화면의 결과를 설명할 수 있습니다.

실행 결과를 설정과 코드로 거슬러 올라갑니다

Game 화면의 raw는 하나의 결과지만, 그 앞에는 역할이 다른 단계가 있습니다. D키의 이름은 Binding에 있고, 스크립트에는 Move를 읽는 코드가 있습니다. 키 경로가 코드에 없어도 값을 읽을 수 있는 이유를 아래 순서에서 찾습니다.

rawValue는 마지막으로 읽은 값을 보관합니다. 키에서 손을 떼면 다음 Update가 새 값 (0, 0)을 읽어 필드를 덮어씁니다. 필드가 입력 장치와 자동으로 동기화되는 것이 아니라, 코드가 다시 읽어서 저장하는 것입니다.

이 코드에서 Update의 대입 줄을 빼면 값을 갱신하지 못합니다. OnGUI의 표시 줄을 빼면 입력값을 읽더라도 Game 화면에서는 볼 수 없습니다. 아직 위치나 속도에 적용하는 줄은 없으므로, 입력 읽기와 표시가 성공해도 캐릭터는 움직이지 않습니다.

다음 단계: 같은 코드에서 키를 오래 누르거나 방향을 바꿨을 때의 값을 비교합니다.

실행 02 · 방향을 바꾸거나 오래 누르면 값은 어떻게 될까요?

실행 전 질문: D를 약 2초 동안 누르면 Move의 x는 계속 1일까요, 2까지 커질까요? 이번에는 캐릭터의 위치보다 두 숫자의 축·부호·유지 시간을 봅니다.

1. D를 짧게 누른 경우와 길게 누른 경우 비교

   같은 장면에서 Play를 시작하고 Game 화면을 클릭합니다. D를 짧게 눌렀다 놓은 뒤, 다시 약 2초간 누릅니다. 처음 누른 순간과 계속 누르고 있는 동안의 숫자를 비교합니다.

   관찰누르는 동안 (1, 0)이 유지됩니다. 값이 1, 2, 3으로 누적되지 않습니다.

2. 한 키씩 바꾸며 축과 부호 비교

   D에서 손을 뗀 뒤 W, A, S를 차례로 누릅니다. 매번 손을 떼어 (0, 0)으로 돌아온 뒤 다음 키를 누릅니다. 한 번에 한 방향만 비교하고 마지막에 Play를 종료합니다.

   관찰W는 y가 양수, A는 x가 음수, S는 y가 음수입니다.

현재 상태는 지금 어떤 조작을 하고 있는지, 변화 시점은 누르기 시작하거나 손을 뗀 때를 뜻합니다. 이동은 누르고 있는 동안 계속 방향이 필요하고, 메뉴 확인 같은 동작은 누른 순간 한 번 처리할 수 있습니다.

매 프레임 현재 입력값을 조회하는 방식을 폴링(polling)이라고 합니다. 이번에는 Update에서 Move를 읽습니다. 입력 변화에 따라 등록한 메서드를 호출받는 이벤트 방식도 있지만, 이동 입력을 이해하는 데 두 방식을 동시에 구현할 필요는 없습니다.

키는 눌림/해제 두 상태를 갖는 디지털 입력이고, 스틱은 기울인 정도가 연속적으로 달라지는 아날로그 입력입니다. 둘 다 Move의 Vector2로 읽지만 스틱은 중간 세기도 표현합니다.

결과 해석: 입력값은 매번 읽는 순간의 조작 상태입니다. D를 오래 눌러도 입력의 세기가 커지는 것은 아닙니다. 이동 코드가 그 상태를 계속 사용하면 이동 시간이 길어져 거리가 늘어날 수 있습니다. 입력의 크기와 입력을 유지한 시간은 서로 다른 정보입니다.

A의 -1은 오류나 음수 거리가 아니라 왼쪽 입력입니다. W의 y=1도 아직 점프 명령이 아닙니다. 같은 Vector2를 받아도 게임 규칙이 어느 성분을 사용하는지에 따라 동작은 달라집니다. 2교시에는 x를 가로 속도에 사용하고, 3교시에는 별도의 Jump Action으로 점프를 구현합니다.

다음 단계: 입력 코드는 두고 Binding을 바꿔 결과를 비교합니다.

실행 03 · 키를 추가하거나 바꿔도 코드는 같을까요?

실행 전 질문: D 대신 오른쪽 화살표를 쓰려면 코드에 화살표 검사문을 추가해야 할까요? 이번에는 먼저 입력 방법을 하나 더 연결하고, 이어서 기존 키의 역할을 바꿉니다. 두 경우 모두 InputValueDisplay.cs는 수정하지 않습니다.

1. Play 종료 후 두 번째 Composite 추가

   Play 모드를 종료하고 Project에서 PlayerControls를 엽니다. Player 맵을 선택한 뒤 Move 행 오른쪽의 +에서 Add Up/Down/Left/Right Composite를 선택합니다. 새 묶음의 이름을 Arrows로 정합니다. 이미 같은 묶음이 있다면 해당 설정을 확인합니다. 기존 WASD 묶음은 그대로 유지합니다.

   Arrows 아래 Up 행을 선택해 Path → Listen으로 위 화살표를 연결합니다. 같은 방식으로 Down=아래, Left=왼쪽, Right=오른쪽을 연결합니다. WASD와 방향키는 서로 다른 Action이 아니라 같은 Move에 입력을 전달하는 두 가지 Binding 구성입니다. Save Asset을 클릭합니다.

   결과Move 아래에 Composite가 두 묶음입니다. 스크립트는 그대로입니다.

2. 한 번에 한 키씩 눌러 같은 출력인지 확인

   다시 Play 모드를 시작하고 Game 화면 안쪽을 클릭합니다. D를 눌러 값을 읽고 손을 뗀 뒤 오른쪽 화살표를 누릅니다. 두 raw가 같은지 비교합니다. W와 위 화살표도 같은 순서로 확인합니다. 두 키를 동시에 누르지 않고 누르기 → 놓기 → 다른 키 누르기로 비교합니다. 코드는 수정하지 않습니다.

   관찰방향키와 WASD가 같은 두 숫자를 만들고, 코드를 수정하지 않았습니다.

3. WASD의 Left와 Right 연결만 교환

   Play를 종료합니다. WASD 묶음의 Left Path를 D, Right Path를 A로 바꾸고 Save Asset을 클릭합니다. Arrows 묶음과 Mode는 그대로 둡니다. 다시 Play하고 Game 화면에서 D만 누른 뒤, 손을 떼고 오른쪽 화살표만 누릅니다.

   관찰D는 (-1, 0), 오른쪽 화살표는 여전히 (1, 0)입니다. 같은 Move를 읽어도 키의 연결 규칙에 따라 부호가 달라집니다.

4. 원래 연결로 복구하고 재확인

   Play를 종료하고 WASD의 Left=A, Right=D로 복구한 뒤 Save Asset을 클릭합니다. 다시 Play해 D와 오른쪽 화살표가 각각 (1, 0)인지 확인하고 Play를 종료합니다. 이후 설명은 이 정상 배치를 기준으로 이어갑니다.

   복구 확인WASD와 Arrows 모두 원래 방향으로 동작합니다. 코드는 처음부터 끝까지 동일합니다.

결과 해석: D키 자체에 오른쪽 이동이라는 의미가 들어 있는 것은 아닙니다. Right에 연결했기 때문에 양수 x를 만들었고, Left에 연결하자 음수 x를 만들었습니다. 반면 오른쪽 화살표는 바꾸지 않은 Arrows의 Right를 사용하므로 결과가 유지됩니다.

방향키 추가는 같은 행동을 실행할 입력 방법을 늘리는 변경이고, 좌우 교환은 기존 키가 맡는 방향을 바꾸는 변경입니다. 두 경우 모두 Move의 Vector2를 읽는 계약은 유지됩니다. 캐릭터의 이동 속도를 바꾸려면 이 Binding이 아니라 다음 교시의 이동 코드를 바꿉니다.

두 묶음을 펼쳐 앞에서 본 Input Actions 완성 화면과 비교합니다. Move 아래 WASD와 Arrows가 각각 있고 네 방향의 키가 연결되어 있으면 됩니다. 두 Composite의 Mode는 1교시에서 사용하는 Digital Normalized로 유지합니다. 2교시의 횡스크롤 이동에서는 두 Composite 모두 Digital로 변경합니다.

다음 단계: 정상적인 입력 없음과 참조 연결 누락을 비교한 뒤 Scene을 정리합니다.

실행 04 · None과 (0, 0)은 어떻게 다를까요?

실행 전 질문: Move Action 슬롯을 비우는 것과 키에서 손을 떼는 것은 같은 상태일까요? 이번에는 입력값뿐 아니라 Inspector의 참조, 컴포넌트 체크박스, Console을 함께 봅니다.

1. 연결된 상태에서 손을 떼기

   InputValueDisplay가 활성이고 Move Action이 PlayerControls / Player / Move인지 확인합니다. Play하고 Game 화면을 클릭한 뒤 D를 눌렀다 놓습니다. 손을 뗀 상태의 표시 상자를 확인한 뒤 Play를 종료합니다.

   관찰상자가 계속 보이고 raw는 (0, 0)으로 돌아옵니다. 읽을 대상은 여전히 연결되어 있습니다.

2. 참조를 비우고 같은 장면 실행

   Edit 모드에서 Move Action 슬롯의 선택 창을 열어 None으로 바꿉니다. InputValueDisplay는 켜 둡니다. Console의 Clear를 눌러 이전 메시지를 지운 뒤 Play합니다. Game 화면과 Player의 컴포넌트, Console을 차례로 확인합니다.

   관찰연결하라는 오류가 표시되고 InputValueDisplay 체크박스가 꺼집니다. 정상적인 (0, 0) 표시를 얻은 것이 아닙니다.

3. 참조를 복구하고 정상 실행 확인

   Play를 종료한 뒤 Move Action에 PlayerControls / Player / Move를 다시 연결하고 InputValueDisplay 체크박스를 켭니다. Scene을 저장하고 Console을 Clear한 뒤 다시 Play합니다. Game 화면에서 D의 (1, 0)과 손을 뗀 상태의 (0, 0)을 확인하고 종료합니다.

   복구 확인입력값 표시가 돌아오고 같은 연결 오류가 다시 발생하지 않습니다. 다음 교시에는 참조가 복구된 Scene을 사용합니다.

결과 해석: (0, 0)은 연결된 Action에서 읽을 수 있는 값입니다. None은 읽을 Action의 참조가 없는 상태입니다. 이 예제는 OnEnable에서 null을 발견하면 오류를 알리고 enabled = false와 return;으로 실행을 멈춥니다. 따라서 참조가 없는 상태를 입력이 없는 상태로 해석하면 안 됩니다.

이때 표시 상자도 사라지는 이유는 컴포넌트가 비활성화되어 Update와 OnGUI가 실행되지 않기 때문입니다. 다만 상자가 없다는 현상만으로 원인을 None이라고 단정할 수는 없습니다. 컴포넌트를 직접 꺼도 표시가 사라지므로, 참조·활성 상태·Console의 메시지를 함께 확인해야 합니다.

정상 설정을 보관하고 이동 수업으로 이어갑니다

참조를 복구한 상태에서 Play를 종료합니다. 2교시 PlayerController가 같은 Move를 활성화하고 비활성화하므로, 입력값 표시 컴포넌트는 아래 순서로 끕니다. 두 컴포넌트가 동일한 Action의 활성화 상태를 동시에 관리하지 않도록 합니다.

1. Play 종료

   Play 버튼을 클릭해 Play 모드를 종료합니다.

   결과Edit Mode입니다.

2. 입력값 표시 컴포넌트 비활성화

   Hierarchy에서 Player를 선택합니다. Inspector의 InputValueDisplay 컴포넌트 제목 왼쪽 체크박스의 선택을 해제해 비활성화합니다. Player 오브젝트와 Sprite Renderer는 활성 상태로 유지합니다. 다음 교시는 같은 캐릭터에 물리 이동을 추가합니다.

   결과캐릭터는 계속 보이고 입력값 표시만 비활성화됩니다.

3. 다음 교시에 이어 쓸 Scene과 입력 설정 저장

   WASD의 Left=A, Right=D와 Move 참조가 복구되어 있는지 확인합니다. Action 편집 창에서 Save Asset을 클릭하고 Unity로 돌아와 Ctrl+S로 Scene을 저장합니다. 저장한 Scene은 Week04_InputPhysics입니다. 실행 예제를 위해 기존 Rigidbody2D의 Simulated를 껐다면 다시 켜고 저장합니다. 2교시에는 같은 Player에 물리 이동을 연결합니다.

   완료 기준Play 모드가 종료되어 있고 Player의 InputValueDisplay만 비활성이며 Scene이 저장되어 있습니다.

다음 단계: 네 번의 실행을 학습 내용 점검 질문과 연결합니다.

• Input System 소개 ↗입력 장치를 게임에 연결하는 Input System의 역할과 패키지 개요
• Input System package for Unity 6.6 ↗Unity 6.6 Editor에 릴리스된 Input System 패키지 정보
• Input Actions ↗Action, Action Map, Binding과 값 읽기의 공식 개념
• Install the Input System ↗Package Manager 설치와 입력 backend 활성화 절차
• Composite Bindings ↗Add Up/Down/Left/Right Composite와 2D Vector 출력
• Vector2Composite.Mode ↗Digital Normalized가 대각선을 길이 1로 맞추고, Digital은 (1, 1)을 그대로 둡니다
• InputActionReference ↗에셋 속 Action을 Inspector에서 연결하는 참조 형식
• InputAction API ↗Enable·Disable과 ReadValue의 역할, 현재 값 읽기
• MonoBehaviour.OnGUI ↗컴포넌트를 비활성화하면 OnGUI도 호출되지 않습니다. 실행 04에서 표시 상자가 사라지는 이유입니다
• Rigidbody2D.simulated ↗물리 시뮬레이션 참여 여부를 정합니다. 물리가 이미 추가된 복습용 Scene의 준비에만 사용합니다
• The Input Debugger window ↗Play 중 활성화된 Action과 연결된 Control을 검사합니다. 이 수업에서는 별도 코드로 Vector2 값을 표시합니다
• Vector2.ClampMagnitude ↗최대 길이를 넘는 벡터만 줄이고, 그 이하 값은 그대로 둡니다
• Vector2.normalized ↗영벡터가 아니면 길이를 항상 1로 만듭니다