入力を設定する

1. まず、[Games (ゲーム)] > [Blank (空白)] > [C++] の順に選択して、「SettingUpInput」という名前の新規プロジェクトを作成します。

2. エディタ で、[Edit (編集)] > [Project Settings (プロジェクト設定)] > [Input (入力)] > [Bindings (バインディング)] に移動します。

Character (キャラクター) は、歩き回る能力を持つ特別なタイプの**ポーン** です。Character は Pawn クラスから拡張され、ワールド内のプレイヤーや AI エンティティの物理表現など、同様のプロパティを継承しています。

1. コンテンツ ドロワー**で、「C++ classes」フォルダに移動して右クリックし、[New C++Class (新規 C++ クラス)] を選択して、親クラスとして [Character]** を選択します。

2. Character クラスに「ExampleCharacter」という名前を付け、[Create Class (クラスを作成)] をクリックします。

![name-your-new-character](NameYourCharacter.png)(w:600)

Camera コンポーネントと **SpringArm コンポーネント**を一緒に使用すると、ゲーム ワールドに合わせて動的に調整できるサードパーソン視点向けの機能が提供されます。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 指定子 は、ブループリント エディタでコンポーネントの可視性を提供するために使用されます。

2. 「ExampleCharacter.cpp」ファイルに移動します。次のライブラリを include 行に追加します。

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

3. 次に、AExampleCharacter コンストラクタで以下を実装します。

       AExampleCharacter::AExampleCharacter()
       {
       //Initialize the Camera Boom    
       CameraBoom = CreateDefaultSubobject<USpringArmComponent>(TEXT("CameraBoom"));
   
       //Setup Camera Boom attachment to the Root component of the class
       CameraBoom->SetupAttachment(RootComponent);
   
       //Set the boolean to use the PawnControlRotation to true.
       CameraBoom->bUsePawnControlRotation = true;
   
       //Initialize the FollowCamera
       FollowCamera = CreateDefaultSubobject<UCameraComponent>(TEXT("FollowCamera"));
   
       //Set FollowCamera attachment to the Camera Boom
       FollowCamera->SetupAttachment(CameraBoom);
       }

   このコンポーネントは「FObjectInitializer::CreateDefaultSubobject」テンプレートを呼び出し、 SetupAttachment メソッドを使用して親の Scene コンポーネントにアタッチされます。カメラ ブームがポーンの コントロール回転 を使用するように設定すると、自身の回転ではなく、その親ポーンの回転を使用します。

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))
            {
                // find out which direction is forward
                const FRotator Rotation = Controller->GetControlRotation();
                const FRotator YawRotation(0, Rotation.Yaw, 0);

                // get forward vector
                const FVector Direction = FRotationMatrix(YawRotation).GetUnitAxis(EAxis::X);
                AddMovementInput(Direction, AxisValue);
            }

        }

        void AExampleCharacter::MoveRight(float AxisValue)
        {
            if ((Controller != NULL) && (AxisValue != 0.0f))
            {
                // find out which direction is right
                const FRotator Rotation = Controller->GetControlRotation();
                const FRotator YawRotation(0, Rotation.Yaw, 0);

                // get right vector 
                const FVector Direction = FRotationMatrix(YawRotation).GetUnitAxis(EAxis::Y);

                // add movement in that direction
                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]
[Player Input コンポーネント](making-interactive-experiences\Input\input-overview) は、プロジェクト内の AxisMapping と ActionMapping をゲーム アクションにリンクさせます。Pawn クラスと Character クラスにはどちらも、継承したメソッドが格納されています。このメソッドはカスタム キャラクター用に使用または拡張することができます。
この例では、Pawn の AddControllerYawInput 関数と AddControllerPitchInput 関数、および Character の 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:
            // Sets default values for this character's properties
            AExampleCharacter();

        protected:
            // Called when the game starts or when spawned
            virtual void BeginPlay() override;

            UPROPERTY(EditDefaultsOnly,BlueprintReadOnly)
            class USpringArmComponent* CameraBoom;

            UPROPERTY(EditDefaultsOnly,BlueprintReadOnly)
            class UCameraComponent* FollowCamera;

              void MoveForward();

              void MoveRight();

        public: 
            // Called every frame
            virtual void Tick(float DeltaTime) override;

            // Called to bind functionality to input
            virtual void SetupPlayerInputComponent(class UInputComponent* PlayerInputComponent) override;

        };

ExampleCharacter.cpp

        // Sets default values
        AExampleCharacter::AExampleCharacter()
        {
            //Initialize the Camera Boom    
            CameraBoom = CreateDefaultSubobject<USpringArmComponent>(TEXT("CameraBoom"));

            //Setup its attachment to the Root component of the class
            CameraBoom->SetupAttachment(RootComponent);

            //Set the boolean to use the PawnControlRotation to true.
            CameraBoom->bUsePawnControlRotation = true;

            //Initialize the Camera Comp
            FollowCamera = CreateDefaultSubobject<UCameraComponent>(TEXT("FollowCamera"));

            //Set its attachment to the Camera Boom
            FollowCamera->SetupAttachment(CameraBoom);
        }

        // Called when the game starts or when spawned
        void AExampleCharacter::BeginPlay()
        {
            Super::BeginPlay();

        }

        void AExampleCharacter::MoveForward(float AxisValue)
        {
            if ((Controller != NULL) && (AxisValue != 0.0f))
            {
                // find out which direction is forward
                const FRotator Rotation = Controller->GetControlRotation();
                const FRotator YawRotation(0, Rotation.Yaw, 0);

                // get forward vector
                const FVector Direction = FRotationMatrix(YawRotation).GetUnitAxis(EAxis::X);
                AddMovementInput(Direction, AxisValue);
            }

        }

        void AExampleCharacter::MoveRight(float AxisValue)
        {
            if ((Controller != NULL) && (AxisValue != 0.0f))
            {
                // find out which direction is right
                const FRotator Rotation = Controller->GetControlRotation();
                const FRotator YawRotation(0, Rotation.Yaw, 0);

                // get right vector 
                const FVector Direction = FRotationMatrix(YawRotation).GetUnitAxis(EAxis::Y);

                // add movement in that direction
                AddMovementInput(Direction, AxisValue);
            }
        }

        // Called every frame
        void AExampleCharacter::Tick(float DeltaTime)
        {
            Super::Tick(DeltaTime);

        }

        // Called to bind functionality to input
        void AExampleCharacter::SetupPlayerInputComponent(UInputComponent* PlayerInputComponent)
        {
        // Set up gameplay key bindings
            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++ Classes」フォルダに移動し、ExampleCharacter を右クリックしてドロップダウン メニューから [Create Blueprint class based on ExampleCharacter (ExampleCharacter をベースにしたブループリント クラスを作成)] を選択します。ブループリントに「BP_ExampleCharacter」という名前を付けます。

2. [Components (コンポーネント)] パネルで、Mesh Skeletal Mesh コンポーネントを選択します。

3. [Details] > [Mesh (メッシュ)] > [Skeletal Mesh (スケルタル メッシュ)] に移動し、ドロップダウン メニューを展開します。[Browser (ブラウザ)] セクションで、[Settings (設定)] アイコンをクリックします。次に、コンテキスト メニューから、[Content (コンテンツ)] > [Show Engine Content (エンジンのコンテンツを表示)] を選択します。

4. TutorialTPP スケルタル メッシュを検索して選択します。

5. [Transform (トランスフォーム)] カテゴリに移動して、メッシュの Location と Rotation のベクター値を (「0.0」、「0.0」、「-90」)

![transform-details](DetailsTransform.png)

GameMode では、一連のゲームのルールを定義します。これらのルールには、ゲーム起動時にプレイヤーがどのようなデフォルト ポーンとしてスポーンされるかが含まれます。作成したプレイヤー キャラクターをスポーンするためには、これらのルールを設定する必要があります。

1. コンテンツ ドロワー で、「C++ Classes」フォルダに移動し、ドロップダウン メニューから SettingUpInputGameModeBase を右クリックし、[Create Blueprint Based on SettingUpInputGameModeBase (SettingUpInputGameModeBase をベースにしたブループリントを作成)] を選択します。ゲーム モード ブループリントに「BP_InputGameMode」という名前を付けます。

2. [Class Defaults (クラスのデフォルト)] で、[Classes (クラス)] > [Default Pawn Class (デフォルトの Pawn クラス)] に移動し、BP_ExampleCharacter を選択します。

3. コンパイル して 保存 します。

4. [Edit (編集)] > [Project Settings (プロジェクト設定)] > [Maps & Modes (マップ & モード)] に移動します。[Default GameMode (デフォルト ゲームモード)] を BP_InputGameMode. に設定します。

5. エディタ に移動し、[Play (Play in Editor) (プレイ (プレイインエディタ))] を選択します。

これで、W、A、S、D キーでキャラクターの動きをコントロールできるようになりました。マウスを動かすとカメラが動き、スペース キーを押すとキャラクターがジャンプします。