Unreal Engine 5 ドキュメントは Epic Developer Community に移動しました

このクイック スタート ガイドでは、Unreal Engine で C++ プロジェクトを構成し、Visual Studio で最初の C++ ゲームプレイ クラスをプログラミングする方法について説明します。このチュートリアルを完了すると、次のことができるようになります。

• 新規 C++ プロジェクトを作成する

• C++ で新規アクタ クラスを作成する

• その C++ クラスを開発環境で編集して視覚的表現と機能を追加する

• プロジェクトをコンパイルする

• Unreal Editor で新規アクタをテストする

1. 必要なセットアップ

Unreal Editor を起動します。 プロジェクト ブラウザ が起動したら [New Project (新規プロジェクト)] タブをクリックして、 [C++] タブを選択したら、「 Basic Code 」テンプレートを選択します。 Starter content (スターター コンテンツ) が有効になっていることを確認したら、希望の 保存場所 を選択して、プロジェクトの 名前 を付けて、 [Create Project (プロジェクトの作成)] をクリックします。このインスタンスでは、プロジェクト名を「QuickStart」としています。このインスタンスでは、プロジェクト名を「QuickStart」としています。

2. 新規 C++ クラスを作成する

1. Unreal Editor で、 [File (ファイル)] ドロップダウン メニューをクリックして、 [New C++ Class... (新規 C++ クラス...)] コマンドを選択します。

   クリックしてフルサイズ表示。

2. [Choose Parent Class (親クラスを選択)] メニューが表示されます既存のクラスを拡張すると、そのクラスの機能を自分のクラスに追加することができます。ワールドに配置できる最も基本的な種類のオブジェクトであるため アクタ を選択して、 [Next (次へ)] をクリックします。

   クリックしてフルサイズ表示。

3. [Name Your New Actor (新しいアクタに名前を付ける)] メニューで、アクタに「 FloatingActor 」と名前を付けて、 [Create Class (クラスの作成)] をクリックします。
   

   クリックしてフルサイズ表示。

   Unreal Engine により、コンテンツ ブラウザで選択した新規クラスが自動的にコンパイルおよびリロードされます。さらに、プログラミング環境で、「 FloatingActor.cpp 」が表示された状態で自動的に開きます。

3. C++ クラスを編集する

4. C++ コードをコンパイルしてテストする

5. 最終結果

これで、ゆっくりと回転しながらテーブルの上で上下に静かに浮遊するキューブが完成しました。

これで C++ のみを使用して、最初の Actor クラスを作成できました。とてもシンプルなオブジェクトであり、C++ のソース コードを使う機能のいくつかでしたが、 ゲームの C++ コードの作成、編集、コンパイルに関する基本事項をすべて確認することができました。今度は、より複雑なゲームプレイのプログラミングに挑戦する準備が整ったので、以下のことに取り組むことをお勧めします。

6. 応用編

シンプルな C++ アクタのビルド方法を理解できたので、設定可能な項目をもっと増やしてみましょう。たとえば、ビヘイビアを制御するための変数を追加できます。

In FloatingActor.h :

...
public: 
    UPROPERTY(EditAnywhere, BlueprintReadWrite, Category="FloatingActor")
    float FloatSpeed = 20.0f;

    UPROPERTY(EditAnywhere, BlueprintReadWrite, Category="FloatingActor")
    float RotationSpeed = 20.0f;
...

In FloatingActor.cpp :

...
NewLocation.Z += DeltaHeight * FloatSpeed;          //Scale our height by FloatSpeed
float DeltaRotation = DeltaTime * RotationSpeed;    //Rotate by a number of degrees equal to RotationSpeed each second
...

ヘッダにこれらの変数を追加して、.cpp で DeltaHeight とDeltaRotation のスケーリングに使用する浮動小数点値を置き換えることで、アクタ選択時に [Details (詳細)] パネルで浮かんで回転する速度を編集できるようになります。

Location (位置)、Rotation (回転) および Scale (スケール) を使用して Tick 関数に他の種類のビヘイビアを追加することで、試すことができます。

C++ に他の種類のコンポーネントをアタッチしてより複雑なオブジェクトを作成することもできます。利用可能な各種コンポーネントの例については、 「コンポーネントを作成しアタッチする」 ガイドを参照して、 浮いているオブジェクトに若干のフレアを追加するパーティクル システムのコンポーネントを追加してみましょう。

最後に、 コンテンツ ブラウザ でアクタ クラスを右クリックすると、C++ または ブループリントでアクタ クラスを拡張して、アクタ クラスの新しいバリエーションを作成できるオプションが表示されます。

これで、各 FloatingActor にユーザーが選択する異なるメッシュまたはパラメータが代入されている FloatingActor の完全なライブラリを作成できます。

サンプル コード

FloatingActor.h

// Copyright 1998-2019 Epic Games, Inc.All Rights Reserved.

#pragma once

#include "CoreMinimal.h"
#include "GameFramework/Actor.h"
#include "FloatingActor.generated.h"

UCLASS()
class QUICKSTART_API AFloatingActor : public AActor
{
    GENERATED_BODY()

public:
    // Sets default values for this actor's properties
    AFloatingActor();

    UPROPERTY(VisibleAnywhere)
    UStaticMeshComponent* VisualMesh;

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

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

};

FloatingActor.cpp

// Copyright 1998-2019 Epic Games, Inc.All Rights Reserved.

#include "FloatingActor.h"

// Sets default values
AFloatingActor::AFloatingActor()
{
    // Set this actor to call Tick() every frame.You can turn this off to improve performance if you don't need it.
    PrimaryActorTick.bCanEverTick = true;

    VisualMesh = CreateDefaultSubobject<UStaticMeshComponent>(TEXT("Mesh"));
    VisualMesh->SetupAttachment(RootComponent);

    static ConstructorHelpers::FObjectFinder<UStaticMesh> CubeVisualAsset(TEXT("/Game/StarterContent/Shapes/Shape_Cube.Shape_Cube"));

    if (CubeVisualAsset.Succeeded())
    {
        VisualMesh->SetStaticMesh(CubeVisualAsset.Object);
        VisualMesh->SetRelativeLocation(FVector(0.0f, 0.0f, 0.0f));
    }
}

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

}

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

    FVector NewLocation = GetActorLocation();
    FRotator NewRotation = GetActorRotation();
    float RunningTime = GetGameTimeSinceCreation();
    float DeltaHeight = (FMath::Sin(RunningTime + DeltaTime) - FMath::Sin(RunningTime));
    NewLocation.Z += DeltaHeight * 20.0f;       //Scale our height by a factor of 20
    float DeltaRotation = DeltaTime * 20.0f;    //Rotate by 20 degrees per second
    NewRotation.Yaw += DeltaRotation;
    SetActorLocationAndRotation(NewLocation, NewRotation);
}