입력 구성

1. 게임(Games) > 기본(Blank) > C++ 프로젝트를 새로 생성하고, 이름은 'SettingUpInput '으로 짓습니다.

2. 에디터**에서 편집(Edit) > 프로젝트 세팅(Project Settings) > 입력(Input) > 바인딩(Bindings)** 으로 이동합니다.

캐릭터는 걸어 다닐 수 있는 특수한 타입의 폰(Pawn) 입니다. 캐릭터는 폰 클래스에서 확장되며 월드 내 플레이어 또는 AI 엔티티의 물리적 표현 등 유사한 프로퍼티를 상속합니다.

1. 콘텐츠 드로어(Content Drawer) 의 C++ 클래스(C++ Classes) 폴더에서 우클릭하여 새 C++ 클래스(New C++ Class) 를 선택한 다음 캐릭터(Character) 를 부모 클래스로 선택합니다.

2. 캐릭터 클래스의 이름을 'ExampleCharacter '로 지정한 다음 클래스 생성(Create Class) 을 클릭합니다.

![새-캐릭터-명명](NameYourCharacter.png)(w:600)

카메라(Camera) 와 스프링 암(SpringArm) 컴포넌트를 함께 사용하면 삼인칭 시점에서 게임 월드를 동적으로 조정할 수 있습니다. 카메라 컴포넌트에는 플레이어의 시점이나 플레이어가 월드를 보는 방식을 나타내는 카메라가 포함됩니다. 스프링 암 컴포넌트는 '카메라 붐'으로 사용되어 플레이어의 카메라가 월드와 충돌하지 않게 합니다.

1. 코드 에디터에서 ExampleCharacter.h 로 이동합니다. 클래스 디폴트(Class defaults) 에서 아래 클래스를 선언합니다.

   protected:
   UPROPERTY(EditDefaultsOnly, BlueprintReadOnly, Category = "Components")
   class USpringArmComponent* CameraBoom;
   
   UPROPERTY(EditDefaultsOnly, BlueprintReadOnly, Category = "Components")
   class UCameraComponent* FollowCamera; |

   UProperty Specifiers는 블루프린트 에디터에서 컴포넌트의 가시성을 제공하는 데 사용됩니다.

2. ExampleCharacter.cpp 파일로 이동합니다. include 행에 다음 라이브러리를 추가합니다.

   #include "GameFramework/SpringArmComponent.h"
   #include "Camera/CameraComponent.h" 

3. 그런 다음 아래의 AExampleCharacter 생성자를 구현합니다.

   AExampleCharacter::AExampleCharacter()
   {
   //카메라 붐 초기화 
   CameraBoom = CreateDefaultSubobject<USpringArmComponent>(TEXT("CameraBoom"));
   
   //클래스의 루트 컴포넌트에 카메라 붐 어태치먼트 설정
   CameraBoom->SetupAttachment(RootComponent);
   
   //PawnControlRotation 사용 부울을 true로 설정
   CameraBoom->bUsePawnControlRotation = true;
   
   //FollowCamera 초기화
   FollowCamera = CreateDefaultSubobject<UCameraComponent>(TEXT("FollowCamera"));
   
   //카메라 붐에 FollowCamera 어태치먼트 설정
   FollowCamera->SetupAttachment(CameraBoom);
   }

   컴포넌트는 FObjectInitializer::CreateDefaultSubobject 템플릿을 호출한 다음 SetupAttachment 메서드를 사용하여 부모 씬 컴포넌트에 어태치합니다. 카메라 붐이 폰의 제어 회전을 사용하도록 설정하면 자신이 아닌 부모 폰의 회전을 대신 사용합니다.

4. 코드를 컴파일합니다.

입력 컴포넌트에 액션/축 함수 생성

1. ExampleCharacter.h 클래스 디폴트에서 다음 입력 함수를 선언합니다.

    protected:

    void MoveForward(float AxisValue);

    void MoveRight(float AxisValue); 

1. ExampleCharacter.cpp 에서 MoveForward 및 MoveRight 메서드를 구현합니다.

    void AExampleCharacter::MoveForward(float AxisValue)
    {
        if ((Controller != NULL) && (AxisValue != 0.0f))
        {
            //앞쪽 찾기
            const FRotator Rotation = Controller->GetControlRotation();
            const FRotator YawRotation(0, Rotation.Yaw, 0);

            //앞쪽 벡터 구하기
            const FVector Direction = FRotationMatrix(YawRotation).GetUnitAxis(EAxis::X);
            AddMovementInput(Direction, AxisValue);
        }

    }

    void AExampleCharacter::MoveRight(float AxisValue)
    {
        if ((Controller != NULL) && (AxisValue != 0.0f))
        {
            //오른쪽 방향 찾기
            const FRotator Rotation = Controller->GetControlRotation();
            const FRotator YawRotation(0, Rotation.Yaw, 0);

            //오른쪽 벡터 구하기 
            const FVector Direction = FRotationMatrix(YawRotation).GetUnitAxis(EAxis::Y);

            //해당 방향으로 이동 추가
            AddMovementInput(Direction, AxisValue);
        }
    } 

1. SetupPlayerInputComponent(UInputComponent* PlayerInputComponent) 메서드에서 다음 코드를 구현합니다.

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

        PlayerInputComponent->BindAction("Jump", IE_Pressed, this, &ACharacter::Jump);
        PlayerInputComponent->BindAction("Jump", IE_Released, this, &ACharacter::StopJumping);

        PlayerInputComponent->BindAxis("MoveForward", this, &AExampleCharacter::MoveForward);
        PlayerInputComponent->BindAxis("MoveRight", this, &AExampleCharacter::MoveRight);
        PlayerInputComponent->BindAxis("Turn", this, &APawn::AddControllerYawInput);
        PlayerInputComponent->BindAxis("LookUp", this, &APawn::AddControllerPitchInput);
    }

[REGION:note]
[플레이어 입력 컴포넌트](making-interactive-experiences\Input\input-overview)는 프로젝트의 축 매핑과 액션 매핑을 게임 액션에 연결합니다. 폰과 캐릭터 클래스는 상속된 메서드를 포함하며 커스텀 캐릭터로 사용되거나 확장될 수 있습니다.
이 예시에서는 폰의 AddControllerYawInput 및 AddControllerPitchInput 함수, 캐릭터의 Jump 및 StopJumping 함수를 사용했습니다.  
[/REGION]

1. 코드를 컴파일합니다.

완성된 코드

ExampleCharacter.h

    #pragma once

    #include "CoreMinimal.h"
    #include "GameFramework/Character.h"
    #include "ExampleCharacter.generated.h"

    UCLASS()
    class SETTINGUPINPUT_API AExampleCharacter : public ACharacter
    {
        GENERATED_BODY()

    public:
        //이 캐릭터의 프로퍼티에 적용되는 디폴트값 설정
        AExampleCharacter();

    protected:
        //게임 시작 또는 스폰 시 호출
        virtual void BeginPlay() override;

        UPROPERTY(EditDefaultsOnly,BlueprintReadOnly)
        class USpringArmComponent* CameraBoom;

        UPROPERTY(EditDefaultsOnly,BlueprintReadOnly)
        class UCameraComponent* FollowCamera;

          void MoveForward();

          void MoveRight();

    public: 
        //프레임마다 호출
        virtual void Tick(float DeltaTime) override;

        //함수 기능을 입력에 바인딩하기 위해 호출
        virtual void SetupPlayerInputComponent(class UInputComponent* PlayerInputComponent) override;

    };

ExampleCharacter.cpp

    //디폴트값 설정
    AExampleCharacter::AExampleCharacter()
    {
        //카메라 붐 초기화 
        CameraBoom = CreateDefaultSubobject<USpringArmComponent>(TEXT("CameraBoom"));

        //클래스의 루트 컴포넌트에 어태치먼트 설정
        CameraBoom->SetupAttachment(RootComponent);

        //PawnControlRotation 사용 부울을 true로 설정
        CameraBoom->bUsePawnControlRotation = true;

        //카메라 컴포넌트 초기화
        FollowCamera = CreateDefaultSubobject<UCameraComponent>(TEXT("FollowCamera"));

        //카메라 붐에 대한 어태치먼트 설정
        FollowCamera->SetupAttachment(CameraBoom);
    }

    //게임 시작 또는 스폰 시 호출
    void AExampleCharacter::BeginPlay()
    {
        Super::BeginPlay();

    }

    void AExampleCharacter::MoveForward(float AxisValue)
    {
        if ((Controller != NULL) && (AxisValue != 0.0f))
        {
            //앞쪽 찾기
            const FRotator Rotation = Controller->GetControlRotation();
            const FRotator YawRotation(0, Rotation.Yaw, 0);

            //앞쪽 벡터 구하기
            const FVector Direction = FRotationMatrix(YawRotation).GetUnitAxis(EAxis::X);
            AddMovementInput(Direction, AxisValue);
        }

    }

    void AExampleCharacter::MoveRight(float AxisValue)
    {
        if ((Controller != NULL) && (AxisValue != 0.0f))
        {
            //오른쪽 방향 찾기
            const FRotator Rotation = Controller->GetControlRotation();
            const FRotator YawRotation(0, Rotation.Yaw, 0);

            //오른쪽 벡터 구하기 
            const FVector Direction = FRotationMatrix(YawRotation).GetUnitAxis(EAxis::Y);

            //해당 방향으로 이동 추가
            AddMovementInput(Direction, AxisValue);
        }
    }

    //프레임마다 호출
    void AExampleCharacter::Tick(float DeltaTime)
    {
        Super::Tick(DeltaTime);

    }

    //함수 기능을 입력에 바인딩하기 위해 호출
    void AExampleCharacter::SetupPlayerInputComponent(UInputComponent* PlayerInputComponent)
    {
    //게임플레이 키 바인딩 설정
        check(PlayerInputComponent);

    PlayerInputComponent->BindAction("Jump", IE_Pressed, this, &ACharacter::Jump);
        PlayerInputComponent->BindAction("Jump", IE_Released, this, &ACharacter::StopJumping);

        PlayerInputComponent->BindAxis("Move Forward", this, &AExampleCharacter::MoveForward);
        PlayerInputComponent->BindAxis("Move Right", this, &AExampleCharacter::MoveRight);
    } 

캐릭터 블루프린트 생성하기

1. C++ 클래스(C++ Classes) 폴더에서 ExampleCharacter 를 우클릭하고 드롭다운 메뉴에서 ExampleCharacter 기반 블루프린트 클래스 생성(Create Blueprint class based on ExampleCharacter) 을 선택합니다. 블루프린트를 BP_ExampleCharacter 로 명명합니다.

2. 컴포넌트(Components) 패널에서 메시(Mesh) 스켈레탈 메시 컴포넌트를 선택합니다.

3. 디테일(Details) > 메시(Mesh) > 스켈레탈 메시(Skeletal Mesh) 의 드롭다운 메뉴를 펼칩니다. 탐색(Browse) 섹션의 세팅 아이콘을 클릭합니다. 그런 다음 컨텍스트 메뉴에서 콘텐츠(Content) > 엔진 콘텐츠 표시(Show Engine Content) 를 선택합니다.

4. TutorialTPP 스켈레탈 메시를 검색하고 선택합니다.

5. 트랜스폼(Transform) 카테고리에서 위치(Location) 및 회전(Rotation) 벡터 값을 (0.0, 0.0, -90 )으로 설정합니다.

![트랜스폼-디테일](DetailsTransform.png)

게임 모드(GameMode)는 게임의 규칙 세트를 정의합니다. 게임을 실행할 때 플레이어가 스폰되는 디폴트 폰도 이러한 규칙에 포함됩니다. 생성한 플레이어 캐릭터를 스폰하려면 규칙을 설정해야 합니다.

1. 콘텐츠 드로어(Content Drawer) 의 C++ 클래스(C++ Classes) 폴더에서 SettingUpInputGameModeBase 를 우클릭합니다. 그런 다음 드롭다운 메뉴에서 SettingUpInputGameModeBase 기반 블루프린트 클래스 생성(Create Blueprint Class Based on SettingUpInputGameModeBase) 을 선택합니다. 게임 모드 블루프린트의 이름을 'BP_InputGameMode '로 변경합니다.

2. 클래스(Class) 디폴트에서 클래스(Classes) > 디폴트 폰 클래스(Default Pawn Class) 로 이동한 다음 BP_ExampleCharacter 를 선택합니다.

3. 컴파일(Compile) 하고 저장(Save) 합니다.

4. 편집(Edit) > 프로젝트 세팅(Project Settings) > 맵 & 모드(Maps and Modes) 로 이동합니다. 디폴트 게임 모드(Default GameMode) 를 BP_InputGameMode 로 설정합니다.

5. 에디터(Editor) 로 이동하고 플레이(Play) 를 선택하여 에디터에서 플레이(Play in Editor) 합니다.

이제 W, A, S, D 키로 캐릭터 이동을 제어할 수 있습니다. 마우스를 움직이면 카메라가 움직이고, 스페이스 바를 누르면 캐릭터가 점프합니다.