Unity - Input System - InputAction

🎮 Unity Input System - InputAction 완전 정복

1. 🧭 InputAction이란?

InputAction은 Unity의 새 Input System에서 사용자의 입력을 추상화하여 "행동" 단위로 정의하는 구성 요소입니다.

예를 들어 Jump, Move, Shoot 같은 게임 내 행동(행위) 을 정의하고, 여기에 어떤 키보드/마우스/게임패드 입력이 연결될지를 설정합니다.

---

📦 InputAction 구성 구조

InputActionAsset
 └─ Action Map (예: Player)
     └─ InputAction (예: Move, Jump)
         └─ Binding (예: WASD, Spacebar, Gamepad A버튼)

• InputActionAsset: 모든 입력 행동을 담는 설정 파일 (보통 .inputactions 확장자)
• Action Map: 논리적인 입력 그룹 (예: Player, UI, Vehicle 등)
• InputAction: 실제 행동 정의 (Move, Jump, Fire 등)
• Binding: 특정 입력 장치와의 연결 (키보드, 마우스, 게임패드 등)

---

⚙️ 기존 방식 vs InputAction

기존 방식	InputAction
Input.GetKeyDown(KeyCode.Space)	InputAction("Jump").performed += ...
코드 내에 직접 키 입력 체크	행동 단위로 추상화된 구조
입력마다 조건문 필요	입력 행동별로 분리 가능
디바이스 변경 시 코드 수정	하나의 Action에 여러 디바이스 바인딩 가능

---

💬 한 마디로 정리하면?

"InputAction은 '어떤 키를 눌렀는가'가 아니라, '어떤 행동을 실행할 것인가'에 집중하는 시스템입니다."

이 방식은 복잡한 입력 처리, 다양한 디바이스 대응, 깔끔한 코드 구조 등을 모두 만족시킬 수 있어 중대형 프로젝트에서 특히 강력한 입력 처리 구조입니다.

---

2. 🎯 InputAction 타입 종류

InputAction을 만들 때 선택할 수 있는 Action Type은 세 가지가 있습니다:

① Button (버튼 입력)

• 가장 기본적인 입력 방식입니다.
• 키보드나 게임패드의 특정 버튼처럼 눌렀다 뗐다의 이벤트를 감지합니다.
• 예: 점프, 공격, 상호작용 등

InputAction jumpAction = new InputAction(type: InputActionType.Button);
jumpAction.performed += ctx => Jump();

• 관련 phase:
  • started: 버튼이 눌리는 순간
  • performed: 동작이 수행된 순간
  • canceled: 버튼에서 손을 뗀 순간

---

② Value (값 입력)

• 방향키, 스틱, 마우스 이동 등 연속적인 값을 처리할 때 사용합니다.
• Vector2, float, int 등 다양한 타입의 값을 받아 처리할 수 있습니다.
• 예: 이동, 마우스 위치, 줌 레벨 등

InputAction moveAction = new InputAction(type: InputActionType.Value);
Vector2 moveDir = moveAction.ReadValue<Vector2>();

---

③ Pass-through (즉시 전달형)

• Unity 이벤트나 다른 처리 로직을 통하지 않고 바로 값 전달이 필요한 경우 사용합니다.
• performed만 호출되며 started, canceled은 호출되지 않습니다.
• 보통 처리 과정을 생략하고 입력 값을 그대로 넘겨야 할 때 사용됩니다.

InputAction lookAction = new InputAction(type: InputActionType.PassThrough);
lookAction.performed += ctx => Look(ctx.ReadValue<Vector2>());

---

✅ 타입 선택 기준 요약

타입	사용 예시	특징
Button	점프, 공격	상태 변화가 있는 단순 입력 처리
Value	이동, 카메라, 줌	값의 변화량을 지속적으로 감지
Pass-through	마우스 이동	빠르고 직접적인 값 전달, 필터 없음

 

3. 🧠 InputAction 이벤트 처리 완전 이해

InputAction의 입력 이벤트는 CallbackContext를 통해 다양한 정보를 제공합니다.

📌 CallbackContext란?

InputAction.CallbackContext는 입력 이벤트가 발생했을 때 전달되는 구조체입니다. 이 안에는 어떤 값이 눌렸는지, 어떤 상태인지 등 중요한 정보가 담겨 있습니다.

---

📍 주요 속성 설명

속성	설명
ctx.phase	입력의 현재 상태 (Started, Performed, Canceled)
ctx.ReadValue<T>()	입력값을 원하는 타입으로 받아옴 (예: Vector2, float, bool)
ctx.control.name	어떤 입력 컨트롤이 눌렸는지 확인 가능

---

✅ phase란?

• Started: 키가 눌리기 시작했을 때 호출
• Performed: 실제 동작이 완료되었을 때 호출 (ex. 스페이스바 눌러서 점프)
• Canceled: 입력이 해제됐을 때 호출 (ex. 키에서 손 뗌)

public void OnJumpInput(InputAction.CallbackContext context)
{
    if (context.phase == InputActionPhase.Started)
    {
        Debug.Log("점프 시작!");
    }
    else if (context.phase == InputActionPhase.Performed)
    {
        Debug.Log("점프 실행!");
    }
    else if (context.phase == InputActionPhase.Canceled)
    {
        Debug.Log("점프 해제!");
    }
}

---

✅ ReadValue()란?

입력으로부터 값을 받을 때 사용되는 함수입니다.

• ReadValue<Vector2>() → 방향키 입력
• ReadValue<float>() → 마우스 휠, 트리거 압력
• ReadValue<bool>() → 단순 버튼 on/off

Vector2 movement = context.ReadValue<Vector2>();

※ 제네릭 타입을 잘못 입력하면 런타임 에러가 발생할 수 있으니 주의해야 합니다.

 

 

 

4. 🧩 PlayerInput 컴포넌트와 InputAction 연동

InputAction을 사용하려면 Unity 오브젝트에 실제 입력을 받을 수단이 필요합니다. 바로 그것이 PlayerInput 컴포넌트입니다.

PlayerInput은 InputActionAsset과 연동되어 입력을 받아 동작을 실행하도록 해주는 중계자 역할을 합니다.

---

✅ PlayerInput의 구성 요소

항목	설명
Actions	사용할 InputActionAsset 파일 지정
Default Map	시작 시 활성화할 Action Map 선택 (예: "Player")
Behavior	이벤트 처리 방식 선택 (SendMessage, UnityEvents, Invoke C# Events 등)
Camera	Look 입력을 카메라 기준으로 보정할 경우 연결

---

⚙️ Behavior 방식 비교

① SendMessage 방식

• Unity의 기본 메시지 시스템 활용
• 액션 이름과 같은 이름의 함수를 MonoBehaviour에서 자동으로 찾아 호출

void OnJump(InputValue value) { ... }

• ✅ 빠른 구현 가능 / ❌ 퍼포먼스 이슈 가능, 함수명 일치 필수

---

② UnityEvents 방식

• 인스펙터에서 액션별로 함수 연결 가능
• 비개발자도 설정 가능하여 협업에 유리
• PlayerInput → Events 탭에서 직접 함수 연결

// PlayerController.cs
public void OnMove(InputAction.CallbackContext context) { ... }

---

③ C# Events 방식

• 가장 유연하고 퍼포먼스가 좋은 방식
• 코드에서 직접 InputAction에 접근하고 .performed += 으로 연결

playerInput.actions["Jump"].performed += ctx => Jump();

• ✅ 코드 기반으로 철저히 제어 가능 / ❌ 초보자에겐 진입장벽 있음

---

🎮 실습 예시: UnityEvents 방식 연결

1. Player 오브젝트에 PlayerInput 컴포넌트 추가
2. Actions에 .inputactions 파일 연결
3. Behavior를 Invoke Unity Events로 설정
4. PlayerController 스크립트에 이벤트 함수 작성
5. 인스펙터에서 해당 액션에 함수 연결

public void OnMove(InputAction.CallbackContext context)
{
    Vector2 input = context.ReadValue<Vector2>();
    // 이동 처리
}

---

🔍 팁: PlayerInput 자동 생성 방지하기

PlayerInput 컴포넌트를 수동으로 붙여 쓰는 경우, 코드나 다른 매니저에서 InputAction을 생성하면 중복 생성될 수 있습니다. 항상 하나의 PlayerInput만 사용하도록 주의.