More than 3 years have passed since last update.

Unreal Engine 4.25 の C++ でアクターを移動する最低限のコードを書く

Last updated at 2021-01-26Posted at 2021-01-15

UE4.25 で C++ を使ってプログラムを書こうと思ったときに、どうやって書くんだったか思い出すための忘備録です。キャプチャ画面は 4.25 のものですが、4.26 でも同じ手順でできることは確認しました。

準備

Unreal Engine 4.25.4
Windows 10
Visual Studio 2019

空のプロジェクトを選んで、C++ プロジェクトを選択しています。スターターコンテンツは無しにしてます。アプリ名は SimpleCpp としました。

やること

レベル中に配置したアクターを上下に往復運動させるプログラムを C++ で書きます。C++のコードは UE のエディタではなく、Visual Studio で基本書きます（VSCode などのエディタで書くこともできます）。

手順

Actor クラスのサブクラスを C++ で作る（UEエディタで）
Visual Studio などで C++ のクラスのコードを編集する
C++で作ったクラスのサブクラスを UE のエディタ上で作る
レベルに配置してビルドする

こんな感じです。

この状態から始めます。

Actor のサブクラスのC++で作る。

コンテンツブラウザで右クリックメニューを出し「新規C++クラス」を選びます。

注意：4.25 まではコンテンツブラウザで「コンテンツ」のパスが選ばれていてもC++クラスを作成できますが、4.26 から上のように「パスの選択」で「C++クラス」に変更してからでないと、右クリックメニューの中に「新規C++クラス」の選択肢が出ないようです。

「ファイル」のメニューから「新規C++クラス」を選ぶこともできます。この場合は、コンテンツブラウザのパスの選択にかかわらず、C++クラスを作成できるメニューを選べるようです。

親クラスを選ぶウィンドウが出るので、Actor クラスを選んで「次へ」を押します。

クラス名を入力して「クラスを作成」を押します。ここでは名前はデフォルトのまま（MyActor）にしてます。これでC++のクラスファイルが作成されます。

作成されたクラスは、コンテンツブラウザの「パスの選択」のアイコンで「C++クラス」を選ぶと、UEエディタ内で確認できます。

MyActor クラスを選んでダブルクリックすると、Visual Studio 上で MyActor.cpp が開かれて編集できます。

なお、C++プロジェクトを選ぶと Visual Studio が UEのエディタと同時に開きます（デフォルトでは）。MyActor クラスを UE側で開かなくても、クラスを作成すれば Visual Studio のウィンドウ上に自動的に反映されます。

アクターを動かすコードを C++ で記述する

フレーム毎に呼び出される Tick の中で、アクター（自分自身）のZ座標を変更することで移動を実現しています。

.h 側は、アクターの初期位置と初期速度（Z軸方向のフレーム毎の移動量）を保持する変数を追加しています。

MyActor.h

#pragma once

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

UCLASS()
class SIMPLECPP_API AMyActor : public AActor
{
	GENERATED_BODY()
	
public:	
	// Sets default values for this actor's properties
	AMyActor();

protected:
	// Called when the game starts or when spawned
	FVector startLocation; // 追加
	float velocity;        // 追加

	virtual void BeginPlay() override;

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

};

クラス名が MyActor ではなく、AMyActor になっていますが、間違いではありません。アクターのサブクラスは、C++ のクラスにするときに A が勝手に頭につくようです（UE エディタ上で Actor と表示されるクラスも、C++ では AActor クラスという名前になっています）。一方で、UEのエディタ側では、C++クラス名の先頭の A は表示されません。この仕様については、知っておく必要があります。

MyActor.cpp

#include "MyActor.h"
#include "Math/UnrealMathUtility.h"

// Sets default values
AMyActor::AMyActor()
{
 	// 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; // これが true でないと Tick は呼び出されない

}

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

        // 初期速度と初期位置の設定をする
	velocity = 1.0f;                           // 追加
	startLocation = this->GetActorLocation();  // 追加
} 

// Called every frame
void AMyActor::Tick(float DeltaTime)
{
	Super::Tick(DeltaTime);
	
        // ここから追加
	FVector location = this->GetActorLocation(); 
	location.Z += velocity; 
	if (location.Z < startLocation.Z || location.Z > startLocation.Z + 500.0f ) {  
		velocity = -velocity;
	}
	this->SetActorLocation(location);
        // ここまで追加
        // 初期位置のZ+500まで上昇したら下降に転じて、0まで下がったらまた上昇させる
}

アクターの位置を取得する GetActorLocation やアクターの位置を設定する SetActorLocation はブループリントと同じような感覚で使えます。基本的に、ブループリントで使える関数はC++でもほぼ同じように使えます。（Timelineのようなマクロは、C++では使えないものもあります）

コードを追加したら、Visual Studio 側でビルド（F6キー）するか、UEのエディタ側で「コンパイル」を押します。エラーが出た場合は修正します。