개요

💡 C++로 플레이어의 캐릭터를 조작할 수 있도록 만들어 보자.

C++을 사용해서 플레이어의 캐릭터에게 W,A,S,D와 Space, 마우스를 사용해서 필수적인 조작이 가능하도록 해보겠습니다.

이번에는 Enhanced Input System을 사용해서 구현해보겠습니다.

1. Old Input System으로 조작 구현
2. Enhanced Input System으로 조작 구현

본론

캐릭터를 조작하기 위한 Key 추가는 Blueprint로 구현할 때와 동일하게 Unreal 에디터에서 진행해주어야 합니다.

키 만들기

Input Action 생성

IA_Move, IA_Look,_IA_Jump 3개를 만들어 주세요.

Input Mapping Context 생성

아래 사진과 같이 설정해주세요.

헤더파일 수정

InputActionValue 추가

헤더파일의 상단에 InputActionValue.h를 include해주세요

#include "InputActionValue.h"
#include "CoreMinimal.h"
#include "GameFramework/Character.h"
#include "MyPlayer.generated.h"

함수 또한 변수와 같이 헤더파일에서 선언 후 정의 단계를 거칩니다.

GENERATED_BODY 오류

위에서 헤더 파일을 추가하면 GENERATED_BODY()가 빨간줄이 직 그이면서 오류가 나타날 겁니다.

상세한 내용은 따로 포스팅을 하겠습니다.

빌드 후 언리얼과 연동하면 오류가 해결됩니다.

IA 변수 추가

우리가 사용할 키입력에 대한 Input Action을 받아올 변수들을 생성해줍니다.

또한 IA들을 묶어서 관리해줄 IMC 변수도 만들어 줍니다.

private:
	// IMC
	UPROPERTY(editanywhere,category=input, meta=(allowprivateaccess = true))
	class UInputMappingContext* DefaultMappingContext;
	// IA_Jump
	UPROPERTY(editanywhere,category=input, meta = (allowprivateaccess = true))
	class UInputAction* JumpAction;
	// IA_Look
	UPROPERTY(editanywhere,category=input, meta = (allowprivateaccess = true))
	class UInputAction* LookAction;
	// IA_Move
	UPROPERTY(editanywhere,category=input, meta = (allowprivateaccess = true))
	class UInputAction* MoveAction;

바인딩 함수 추가

각 키입력에 대해서 실행될 함수들을 선언해주세요.

	void Move(const FInputActionValue& value);
	void Look(const FInputActionValue& value);
	void Jump() override;

---

소스파일 수정

헤더 추가

소스 파일에 아래의 헤더 3개를 추가해주세요.

#include "EnhancedInputComponent.h"
#include "EnhancedInputSubsystems.h"
#include "InputMappingContext.h"

아마 오류가 나서 추가가 안되시는 분들이 계실 수 있는데 일단 당황하지 마시고 이어서 작성하겠습니다.

입력 매핑 로드

생성한 IA변수들에 대해서 프로젝트 내에서 정의된 입력 매핑 컨텍스트와 입력 액션들을 로드해서 참조를 할당해주어야 합니다.

플레이어의 생성자 부분에서 코드를 작성해주세요.

AMyPlayer::AMyPlayer()
{
	// 생략

	static ConstructorHelpers::FObjectFinder<UInputMappingContext>DEFAULT_CONTEXT(TEXT("/Script/EnhancedInput.InputMappingContext'/Game/Input/IMC_Player.IMC_Player'"));
	
	static ConstructorHelpers::FObjectFinder<UInputAction>IA_MOVE(TEXT("/Script/EnhancedInput.InputAction'/Game/Input/IA_Move.IA_Move'"));
	static ConstructorHelpers::FObjectFinder<UInputAction>IA_JUMP(TEXT("/ Script / EnhancedInput.InputAction'/Game/Input/IA_Jump.IA_Jump'"));
	static ConstructorHelpers::FObjectFinder<UInputAction>IA_LOOK(TEXT("/ Script / EnhancedInput.InputAction'/Game/Input/IA_Look.IA_Look'"));

	if (DEFAULT_CONTEXT.Succeeded())
	{
		DefaultMappingContext = DEFAULT_CONTEXT.Object;
	}

	if (IA_MOVE.Succeeded())
	{
		MoveAction = IA_MOVE.Object;
	}
	
	if (IA_JUMP.Succeeded())
	{
		JumpAction = IA_JUMP.Object;
	}

	if (IA_LOOK.Succeeded())
	{
		LookAction = IA_LOOK.Object;
	}

}

Enhanced Input Local Player Subsystem

저희가 블루프린트로 Enhanced Input을 구현할 때 아래 사진처럼 구현한 것을 기억나시나요?

이걸 직접 코드로 작성해주어야 합니다.
BeginPlay()에서 작성해주세요.

void AMyPlayer::BeginPlay()
{
	Super::BeginPlay();
	

	if (APlayerController* PlayerController = Cast<APlayerController>(GetController()))
	{
		if (UEnhancedInputLocalPlayerSubsystem* SubSystem =
			ULocalPlayer::GetSubsystem<UEnhancedInputLocalPlayerSubsystem>(PlayerController->GetLocalPlayer()))
		{
			SubSystem->AddMappingContext(DefaultMappingContext, 0);
		}
	}
}

코드만 보고 따라하신다면 이게 뭐야.. 하실 수 있겠지만 각 코드 한줄 한줄이 블루프린트 사진과 비교해보시면 딱 느낌이 오실 겁니다.

함수 바인딩

키 입력을 받을 수 있도록 구현하였으니 입력과 실행될 함수를 바인딩 해주겠습니다.

SetupPlayerInputComponent로 이동해서 작성해주세요.

void AMyPlayer::SetupPlayerInputComponent(UInputComponent* PlayerInputComponent)
{
	Super::SetupPlayerInputComponent(PlayerInputComponent);


	if (UEnhancedInputComponent* EnhancedInputComponent = CastChecked<UEnhancedInputComponent>(PlayerInputComponent))
	{
		EnhancedInputComponent->BindAction(MoveAction, ETriggerEvent::Triggered, this, &AMyPlayer::Move);
		EnhancedInputComponent->BindAction(LookAction, ETriggerEvent::Triggered, this, &AMyPlayer::Look);
		EnhancedInputComponent->BindAction(JumpAction, ETriggerEvent::Triggered, this, &AMyPlayer::Jump);
	}

}

Move() 구현

Move 함수를 구현하겠습니다.
상세한 설명은 주석으로 대체하겠습니다.

void AMyPlayer::Move(const FInputActionValue& Value)
{
	// 이동에 사용될 방향과 속도를 나타냄
	const FVector2D MovementVector = Value.Get<FVector2D>();
	// 플레이어의 현재 방향
	const FRotator Rotation = Controller->GetControlRotation();
	// Yaw만을 사용해 새로운 회전 생성
	const FRotator YawRotation(0.f, Rotation.Yaw, 0.f);
	// Yaw회전을 기준으로 전방 방향 계산
	const FVector ForwardDirection = FRotationMatrix(YawRotation).GetUnitAxis(EAxis::X);
	// 전방 방향과 Y값(전방 이동속도)을 사용하여 이동
	AddMovementInput(ForwardDirection, MovementVector.Y);
	// Yaw회전을 기준으로 우측 방향 계산
	const FVector RightDirection = FRotationMatrix(YawRotation).GetUnitAxis(EAxis::Y);
	// 우측 방향과 X값(우측 이동속도)을 사용하여 이동
	AddMovementInput(RightDirection, MovementVector.X);
}

Look() 구현

Look함수를 구현하겠습니다.

Yaw와 Pitch를 조절해주어야 합니다.

void AMyPlayer::Look(const FInputActionValue& Value)
{
	// 회전량
	const FVector2D LookVector = Value.Get<FVector2D>();
	// X값(수평 회전량)을 사용해 yaw회전 추가 > 수평 시선 회전
	AddControllerYawInput(LookVector.X);
	// Y값(수직 회전량)을 사용해 pitch회전 추가 > 수직 시선 회전
	AddControllerPitchInput(LookVector.Y);
}

Jump() 구현

Jump는 캐릭터에 있는 점프를 그대로 사용하도록 하겠습니다.

void AMyPlayer::Jump()
{
	Super::Jump();
}

여기까지로 구현은 모두 끝났습니다.
근데 빨간줄이 곳곳에 그여 계신 분들이 계실겁니다.

---

오류 해결

모듈 추가

본인 프로젝트의 Games - Config - Source - <프로젝트명 파일>로 이동하면 프로젝트명.Build.cs가 있습니다.
해당 파일을 열어주세요.

그리고 EnhancedInput을 추가로 적어주세요.

필요한 모듈을 추가해주어야 합니다.
추후 화면에 표시될 위젯을 사용할 땐 UMG를 추가로 적어 주어야 합니다.

여러 해결 방법

1. 껏다 켜보세요. 이거 중요합니다.

2. 다시 빌드를 해보세요.

3. 프로젝트 파일로 이동해서 프로젝트.exe를 우클릭해서 Generate Visual Studio project files를 해주세요.
   

컴퓨터가 가끔 거짓말을 합니다...

❗저장 후 실행❗해보면 플레이어를 조작할 수 있습니다.

---

마무리

캐릭터에게 Enhanced Input System을 사용해서 기초적인 움직임이 가능하도록 구현했습니다.

원인을 알 수도 없는 에러가 마구마구 나타나서 원인을 파악하고자 많이 연구해 볼 수 있는 시간이였습니다.

언리얼 엔진의 버전에 따라, 또 Visual Studio의 버전에 따라 모두 다르게 나타나는 에러라고 합니다.

1. Old Input System으로 조작 구현
2. Enhanced Input System으로 조작 구현