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

Unreal Engine 4.26

Unreal Engine 4.27

Unreal Engine 5.0

Unreal Engine 5.1

Unreal Engine 5.2

Unreal Engine 5.3

> 基本を理解する > Unity 引っ越しガイド

Light Theme

Dark Theme

Unity 引っ越しガイド

Unity の操作内容を UE4 の該当する部分と比較して説明し、UE4 の迅速な習得を支援します。

Choose your operating system:

Windows

macOS

Linux

エディタ

以下は Unity のエディタと Unreal Editor の画面です。一般的な機能を表すために色分けされています。各ブロックには、該当する UE4 用語が示されています。Unreal Editor のレイアウトは、タブをドラッグアンドドロップすることで完全にカスタマイズ可能です。

アセットの編集

Unity では、インスペクター (Inspector) タブを使用してプロジェクト内で選択したアセットを編集します。UE4 では、 [Details (詳細)] パネルに選択したオブジェクトのプロパティが表示されますが、編集タスクが大きい場合は、専用のウィンドウやタブになります。編集した各アセットに対して新しくタブ化されたウィンドウが開きます。ウェブブラウザのタブと同様です。当然、スタンドアロンのウィンドウとしてタブを自由にドラッグしたり、フロートさせたりできます。

クイック用語集

以下のセクションでは、左側に一般的な Unity 用語を、右側にそれに相当する (またはほぼ同等の) UE4 用語を表示しています。UE4 のキーワードは Unreal Engine のオンラインドキュメントの詳細情報に直接リンクしています。


カテゴリ	Unity	UE4
ゲームプレイタイプ	コンポーネント	コンポーネント
	GameObject	アクタ , ポーン
	プレハブ	ブループリントクラス
エディタ UI	ヒエラルキーパネル	ワールドアウトライナー
	インスペクター	詳細パネル
	プロジェクトブラウザ	コンテンツブラウザ
	シーンビュー	ビューポート
メッシュ	メッシュ	スタティックメッシュ
	スキンメッシュ	スケルタルメッシュ
マテリアル	シェーダ	マテリアル、マテリアルエディタ
	マテリアル	マテリアルインスタンス
エフェクト	パーティクルエフェクト	エフェクト、パーティクル、カスケード
	Shuriken (パーティクルシステム)	カスケード
ゲーム UI	UI	UMG (アンリアル) モーショングラフィックス
アニメーション	アニメーション	スケルタルアニメーションシステム
	Mecanim	ペルソナ , アニメーションブループリント
2D	スプライトエディター	Paper2D
プログラミング	C#	C++
	スクリプト	ブループリント
物理	Raycast	Line Trace, Shape Trace
	リジッドボディ	コリジョン、物理
実行時プラットフォーム	iOS Player、Web Player	プラットフォーム

プロジェクトとファイル

ディレクトリやファイルは？

Unity プロジェクトと同様に Unreal プロジェクトは常に独自のディレクトリにあり、独自のプロジェクトファイルを持ちます。 .uproject ファイルをダブルクリックしてゲームを Unreal Editorにロードすることができます。または 右クリック してさらにオプションを表示させることができます。プロジェクトフォルダには、ゲームのコンテンツ、ソース、様々なコンフィギュレーションファイルやバイナリを入れる様々なサブフォルダがあります。最も重要なのは、 Content と Source サブフォルダです。

アセットを入れる場所は？

UE4 では、各プロジェクトに Content フォルダがあります。Unity プロジェクトのアセットフォルダと同様に、ここにゲームアセットを格納します。ゲームにアセットをインポートするには、プロジェクトの Content ディレクトリにファイルをドロップすると、自動的にインポートされて コンテンツブラウザ に表示されます。外部プログラムを使用してファイルに変更を加えるとエディタ内のアセットは自動的に更新されます。

サポートされる共通ファイル形式は？

Unity では幅広いファイル形式をサポートしています。UE4 では以下のように非常に一般的なファイル形式をサポートしています。


アセットタイプ	サポートするファイル形式
3D	.fbx, .obj
テクスチャ	.png, .jpeg, .bmp ,.tga, .dds, .exr, .psd, .hdr
サウンド	.wav
Fonts	.ttf, .otf
ビデオ	.mov, .mp4, .wmv

シーンの保存方法は？

Unity では、GameObject をシーンに配置し、それを Scene アセットファイルとして保存します。Unreal Engine には、Unity のシーンに類似する マップファイル があります。マップファイルには、 レベル とその中のオブジェクトに関するデータだけでなく、ライティングデータや一部のレベル固有の設定も格納されます。

プロジェクト設定の変更方法は？

すべてのプロジェクト設定はメインメニューの Edit (編集) / Project Settings (プロジェクト設定) にあります。Unity のプロジェクト設定と同様に、プロジェクトに関する情報 (プロジェクト名やアイコンなど) を指定できます。ゲームの入力バインディングを設定したり、プロジェクト実行時のエンジンの挙動を定義できます。個々のプロジェクト設定については

[こちら](Basics/Projects/ProjectSettings)

を参照してください。Unity には、「プレイヤー設定」と呼ばれるものもあります。アンリアルでは、「プラットフォーム設定」 (platform settings) に相当し、プロジェクト設定の「プラットフォーム」カテゴリにあります。

ソースファイルの行先は？

Unityでは、C# のソースファイルをアセットフォルダに入れていました。

UE4 では違います。C++ コードを持つプロジェクトでは、プロジェクトディレクトリの下に Source サブフォルダがあります。ここには、 C++ ソース (.cpp) ファイルおよびヘッダー (.h) ファイル、一部のビルドスクリプト (.Build.cs、.Target.cs) を含む様々なファイルが入ります。しかし、ブループリントだけのプロジェクトには Source フォルダはありません。

UE4 で C++ を使用して作業を開始する最も簡単な方法はエディタを使用して (メインのファイルメニューで) Add Code to Project (プロジェクトにコードを追加) するか、または単純に数多くあるテンプレートのひとつを使用して最初から C++ プロジェクトを新規作成します。 コンテンツブラウザ の中で C++ クラスを見つけて、そのアイコン上を ダブルクリック して Visual Studio または Xcode でファイルを開くことができます。

GameObjects からアクタへ

GameObject はどこに？

Unity では GameObject はワールドに配置可能な「もの」でした。これに相当するものは UE4 ではアクタになります。Unreal Editor では、新しい Empty Actor (空のアクタ) を [Placement (配置)] パネルからビューポートにドラッグできます。

Empty Actor からゲームをビルドできますが、UE4 にはポーン (プレイヤーまたはAI のオブジェクト用) やキャラクター (アニメートされたクリーチャー用) などのビルドイン機能を持つ特殊タイプのアクタがあります。Empty Actor と同様に、こうした特殊タイプのアクタをドロップして、プロパティやコンポーネントを追加したり、カスタマイズすることができます。後で詳しく説明しますが、ここでは UE4 にはゲームプレイのフレームワークがあることを覚えておいてください。

UE4 のアクタは Unity の GameObject とは少々異なります。Unity では GameObject は直接拡張できない C# クラスです。UE4 ではアクタは C++ のクラスであり、継承を用いて拡張しカスタマイズできます。これについては後で詳しく説明します。

コンポーネントはどこに？

Unity では、コンポーネントを GameObject に追加し、機能を加えます。

UE4 では、コンポーネントをアクタに追加します。レベルに Empty Actor をドロップしたら、 ( [Details (詳細)] パネルにある) [Add Component (コンポーネント追加)] ボタンをクリックして、追加するコンポーネントを選択します。ここでは、Empty Actor をドロップして、たいまつを作成し、ベースとしてメッシュコンポーネントを追加し、続いて光源を、そしてパーティクルシステムを追加し炎を作ります。

Unity では、GameObject はコンポーネントのフラットリストを保持します。UE4 では、アクタは互いにアタッチされたコンポーネントの階層が実際にあります。上の例を見るとわかります。ライトとパーティクルがメッシュにアタッチされています。これは、後で複合アクタと GameObject で説明するいくつかの重要な内容を含みます。

Unity のプレハブから UE4 のブループリントクラスへ

Unity のワークフローはプレハブに基づいています。Unity では、コンポーネントを用いて GameObject のセットをビルドして、そこからプレハブを作ります。ワールドにプレハブのインスタンスを配置するか、実行時にインスタンス化することができます。

UE4 でこれに対応するワークフローはブループリントクラスに基づくものです。UE4 では、コンポーネントでアクタをビルドし、それを選択し、 ( [Details (詳細)] パネルで) [Blueprint / Add Script] ボタンをクリックします。続いてブループリントクラスを保存する場所を選択して、 [Create Blueprint (ブループリント作成) ] をクリックして新しいブループリントクラスを保存します。

新しいブループリントクラスは、 コンテンツブラウザ にあります。 ダブルクリック して直接編集できます。またはどのレベルにでもドラッグアンドドロップできます。

スクリプトコンポーネントと MonoBehaviour はどこに？

Unity では、GameObject にドロップし、C# スクリプティングを追加するスクリプトコンポーネントがあります。MonoBehaviour から継承するクラスを作成し、そのコンポーネントが行うことを定義します。

UE4 にも類似したものがあります。全く新しいコンポーネントクラスを独自に作成し、アクタにドロップすることができます。ブループリントスクリプティングや C++ のいずれかを用いてコンポーネントクラスを作成できます。

UE4 で独自のコンポーネントクラスを作成するにはどうしたらよいでしょうか？ [Details (詳細)] パネルの [Add Component (コンポーネントを追加)] ドロップダウンで、新規コンポーネントを作成するか、既存のコンポーネントを選択できます。

Unity では、新規 MonoBehaviour を作成する場合、Start() 関数と Update() 関数を持つスケルトンクラスファイルが与えられます。

UE4 でも InitializeComponent() 関数と TickComponent() を持つスケルトンクラスが与えられます。これらは、Start および Update と類似した関数を実行します。

ブループリントスクリプティングコンポーネントを作成すると、こうした関数と同じものが以下のようにビジュアルノードとして用意されます。

スクリプト可能な Actor ブループリントクラス

UE4 の優れた機能をご紹介します。新規 Actor ブループリントクラスは、独自のブループリントビジュアルスクリプティングを持ちます。これにより、個々のコンポーネントだけでなく、オブジェクト全体にロジックを追加できます。継承と組み合わせると (以下で説明)、ゲームデザインのフレキシビリティが非常に高くなります。

ビジュアルスクリプトをサポートするブループリントクラスに加えて、UE4 ではコードで実装された C++ クラスもサポートしています。以下は、Unity と UE4 コード、UE4 ブループリントの比較です。

Unity C#	UE4 C++
` using UnityEngine; using System.Collections; public class MyComponent :MonoBehaviour { int Count; // Use this for initialization. void Start () { Count = 0; } // Update is called once per frame. void Update () { Count = Count + 1; Debug.Log(Count); } }`	` #pragma once #include "GameFramework/Actor.h" #include "MyActor.generated.h" UCLASS() class AMyActor : public AActor { GENERATED_BODY() int Count; // Sets default values for this actor's properties. AMyActor() { // Allows Tick() to be called PrimaryActorTick.bCanEverTick = true; } // Called when the game starts or when spawned. void BeginPlay() { Super::BeginPlay(); Count = 0; } // Called every frame. void Tick(float DeltaSeconds) { Super::Tick(DeltaSeconds); Count = Count + 1; GLog->Log(FString::FromInt(Count)); } };`

Unity C#

UE4 C++

    using UnityEngine;
    using System.Collections;

    public class MyComponent :MonoBehaviour
    {
        int Count;

        // Use this for initialization.
        void Start ()
        {
            Count = 0;
        }

        // Update is called once per frame.
        void Update () 
        {

            Count = Count + 1;
            Debug.Log(Count);
        }
    }`

    #pragma once
    #include "GameFramework/Actor.h"
    #include "MyActor.generated.h"

    UCLASS()
    class AMyActor : public AActor
    {
        GENERATED_BODY()
        int Count;

        // Sets default values for this actor's properties.
        AMyActor() 
        {
            // Allows Tick() to be called
            PrimaryActorTick.bCanEverTick = true;  
        }

        // Called when the game starts or when spawned.
        void BeginPlay()
        {
            Super::BeginPlay();
            Count = 0;
        }

        // Called every frame.
        void Tick(float DeltaSeconds)
        {
            Super::Tick(DeltaSeconds);
            Count = Count + 1;
            GLog->Log(FString::FromInt(Count));
        }
    };`


UE4 ブループリント

UE4 のブループリントクラスは拡張可能

Unity のプレハブと UE4 のブループリントクラスは同じようにゲーム内でインスタンス化できます。しかし、Unity では他のプレハブ内にプレハブをネストすることで複雑になります。そのため、拡張可能な構成要素としては制約があります。

UE4 では、既存のブループリントクラスを拡張して、新規ブループリントクラスを作成し、新しいプロパティ、コンポーネント、ビジュアルスクリプト機能で強化します。

例えば、UE4 で、Monster という名前のブループリントクラスを作成するとします。このクラスに、人間を追いかけるなどのモンスターの基本機能を実装します。それを拡張するブループリントクラスをさらに作成できます。ドラゴン (火を吐く機能を追加したタイプのモンスター)、グルー (暗くなるとプレイヤーがその餌食になるかもしれないモンスター) など、他に 8 つあるとします。こうした Monster のサブクラスは Monster の基本機能を継承し、それに新しい機能を追加します。

Unity では、多くの異なる GameObject プレハブを作成して実装します。ひとつはドラゴン用、もうひとつはグルー用などです。例えば、すべてのモンスターに新しい機能を追加したいとします。新しい Speak コンポーネントを使用して会話機能を与えるなどです。Unity では、10 個のプレハブをすべて更新し、新しい機能を個別にコピーし、貼り付けなければなりません。

UE4 では、単に Monster ブループリントクラスを修正し、新しい会話機能を追加するだけです。本当にこれだけです。ドラゴン、グルー、その他 8 つの他のモンスターのサブクラスは新しい会話機能を自動的に継承し、これらに手を加える必要はありません。

まだまだ素晴らしいことがあります。ここでブループリントクラスに関して言及したことは、 C++ クラスにも同様にあてはまり、アクタやコンポーネントでも同じことが言えます。こうしたシステムは、拡張機能の大規模な開発に対応するように設計されています。数十名、数百名という開発者を抱えるプロジェクトに合わせて調整できます。

ブループリントスクリプティング、C++ のいずれかを使用、または両方使用するのか？

ブループリントのビジュアルスクリプティングは、ゲーム内の単純な論理フローやアクションの順序付けに理想的なものです。デザイナー、アーティスト、ビジュアル指向のプログラマにとって素晴らしいシステムです。ゲーム内のオブジェクトに簡単にアクセスし、視覚的に制御できるからです。ブループリントだけを使用して小さなスタンドアロンのゲームを作ることだってできます。本格的な例として Tappy Chicken のサンプルをご覧ください。

C++ プログラミングは大規模なタスク用です。ゲームプレイシステム、複雑な AI、新しいエンジン機能などがこれに該当します。既に何らかの C++ のご経験がありましたら、「 UE4 におけるC++ プログラミングの基礎」を参照してください。

ほとんどのプロジェクトでは、ブループリントと C++ を合わせて使用することでしょう。多くの開発者は、ブループリントを使用してゲームの機能のプロトタイプを作ります。ブループリントはとても簡単で楽しいものだからです。後でパフォーマンスやエンジニアリングの精度を上げるために一部またはすべてを C++ に移動します。

ブループリントクラスは C++ クラスを拡張可能

UE4 ゲーム開発の素晴らしさは、プログラマが C++ で新規機能を実装し、デザイナーとアーティストがその新規機能をブループリントで利用して、プログラマに更なる機能を求めるという相互作用にあります。以下は、ピックアップシステムを実装する UE4 ベースのシューティングゲームをあるチームが構築するのに、C++ クラスのシステムプログラミングに、挙動と外観のためのブループリントクラスを混在させて使用した例です。

Transform コンポーネント

Unity では各ゲームオブジェクトには Transform コンポーネントがあります。これは、ゲームオブジェクトにワールドでの位置、回転、スケールを与えます。

同様に UE4 には、アクタにはシーンコンポーネントのどのサブクラスにもなりうる ルートコンポーネント があります。 シーンコンポーネント は、アクタにワールド内での位置、回転、スケールを与えます。これは、その配下にあるすべてのコンポーネントに階層的に適用されます。使用する多くのコンポーネントは、シーンコンポーネントのサブクラスです。位置を持つのに非常に便利だからです。

Empty Actor を配置した場合でも、UE4 はそのアクタに対する「デフォルトシーンルート」を作成します。これは、単にシンプルなシーンコンポーネントです。独自の新しいシーンコンポーネントをドロップすると、デフォルトシーンルートを置き換えます。

複合オブジェクト

Unity では、以下のようにゲームオブジェクトの階層を構築し、transform (変換行列) を親子付けします。

UE4 では、以下のようにコンポーネントの階層をネストして複合ゲームオブジェクトを作ります。

図からわかるように、ネストした階層はシーンコンポーネントを互いにアタッチして作ることができます。Unity で親子にする transform と同じような transform を持つからです。アクタコンポーネント (すべてのクラスの基底クラス) は、アクタそのものだけに直接アタッチすることができます。

コンポーネントから何もかもビルドするのでしょうか？

ユーザー次第ですが、ほとんどの場合、カスタムコンポーネントタイプとこうしたコンポーネントを使用するアクタクラスを組み合わせて使用しています。しかし、前述のように UE4 には、ある程度の機能を持つ特殊なタイプのアクタが数多くあり、常にいくつかのコンポーネントが含まれています。例えば、 Character には常に Character Movement コンポーネント が含まれます。

エンジン内ですぐに見つかるサブクラス化されたアクタタイプがいくつかあり、ほぼすべてのタイプのゲームで役立ちます。以下は、非常に一般的なビルトインアクタのリストです。

ポーン - アクタの一種で、制御可能なゲームオブジェクトを表します。通常、プレイヤーのアバターです。プレイヤーおよび同様に AI は、所有しているコントローラを通してポーンを動かします。
キャラクター - 二足動物のアバター用にデザインされたポーンの特殊バージョンであり、こうしたゲームオブジェクトの複雑さに対処します。
コントローラー - ポーンを所有し制御します。ポーンをコントローラーから分離することで、プレイヤーが使用するのと同じインターフェースを使用してポーンを操作できる AI コントローラーを記述することができます。
プレイヤーコントローラー - プレイヤーのゲームパッド、タッチ、マウス/キーボードから入力を受け、その入力を使用して所有するポーンまたはキャラクタを動かすように設計された特殊なコントローラーです。

何もかもがアクタということでしょうか？

いいえ、違います。 アクタ は、UE4 でのゲームプレイに使用される非常に一般的なクラスであり、 ワールド に スポーン できる唯一のタイプです。そのため、レベルに配置するものは何でもアクタになります。

もうひとつ理解すべき重要なタイプは、 Object (オブジェクト) です。オブジェクトは実際に アクタ やその他多くのものを含むすべてのアンリアルクラスの基底クラスです。これはアクタよりもはるかに低レベルの構造体ですが、 リフレクション や シリアル化 といったアンリアルクラスで求められる機能を持っています。オブジェクトは、 アクタ の型にはまらない新しいタイプを定義する必要がある場合に使用する非常に基本的なクラスです。例えば、 アクタコンポーネント はすべてのコンポーネントの基底クラスであり、 アクタ の代わりに オブジェクト から派生します。

UE4 のゲームプレイフレームワークはどのようなものですか？

そうですね、ここから話が少々すごいことになります (良い意味で)。Unity では、ゲームデザインを開始するための白紙の状態があります。アンリアルでも同様です。Unityでは、基本的なゲームオブジェクトとコンポーネントから何もかもを構築できます。一方、アンリアルではアクタとコンポーネントからすべてのものを構築できます。

しかし、アンリアルにはこれに加えてゲームプレイフレームワークと呼ばれる追加のレイヤーがあります。これは Unity には全く存在しません。Unreal Engine でこれを使用しなくてもかまいませんが、実に素晴らしいものです。基本的に、基本的なプリミティブクラスを使用し、定められた決まりに従うと、いくつかの優れた機能が自動的に取得されます。自動取得しなければ、こうした機能は、実装や改良が非常に難しいものです (フルマルチプレイヤーサポートなど)。

数えきれない素晴らしいゲームがアンリアルのゲームプレイフレームワークで設計されてきました。多少の時間を費やしても、この仕組みを理解する価値はあります。もちろん、独自のやり方で開始することもできるでしょう。それがお望みならば全く問題ありません。しかし、何百もの優れたアンリアルを使った開発者が、UE4 のこのフレームワークをうまく活用してきました。だから、少し時間をかけて学ぶ価値はあります。

ゲームプレイフレームワークを使用するには、Unreal Engine にあるカスタマイズされたビルトインのアクタクラスについて学習する必要があります。こうしたクラスには、 ポーン 、 キャラクター および プレイヤーコントローラ があり、最終的にはレプリケーションとネットワーク機能の仕組みを理解する必要があります。しかし、ここでは基本に戻ります。

UE4 でコードを記述する方法

MonoDevelop プログラマー向け

ブループリントスクリプティングでは、Unreal Editor さえあれば大丈夫です。何もかもがビルトインされています。C++ でコードを記述するには、Windows の場合は Visual Studio の無料バージョンを、Mac の場合は Xcode のインストールをダウンロードしてください。初めて新規プロジェクトを作成する場合 (または既存プロジェクトにコードを追加する場合)、UE4 では Visual Studio プロジェクトファイルを自動的に作成します。Visual Studio を開くには以下の手順に従います。 コンテンツブラウザ 内で C++ クラスを ダブルクリック するか、メインファイルメニューで [Open Visual Studio] をクリックします。

UE4 でのひとつの重要な違い： Visual Studio プロジェクトファイルを手動でリフレッシュしなければならない場合があるでしょう (例、UE4 の新バージョンのダウンロード後、またはディスク上でソースファイルの場所を手動で変更する場合)。手動リフレッシュを行うには、メインメニューで "Refresh Visual Studio Project" をクリックするか、プロジェクトディレクトリにある .uproject file 上で 右クリック します。

イベント関数 (Start、Update、など) の記述

MonoBehaviors での作業に馴染みのある場合、Start、Update、OnDestroy などのメソッドに慣れていることでしょう。以下は Unity の挙動とそれに相当する UE4 のアクタとコンポーネントを比較したものです。

Unity では、以下のような単純なコンポーネントがあるでしょう。

public class MyComponent :MonoBehaviour
{
    void Start() {}
    void OnDestroy() {}
    void Update() {}
}

しかし、UE4 では新規コンポーネントタイプだけをコーディングするのではなく、アクタそのものに対してコードを記述できます。これは実際、非常に一般的であり、便利です。

Unity の Start、OnDestroy、および Update の関数と同様に、以下のように UE4 には類似のアクタのメソッド一式があります。

C++ :

UCLASS()
class AMyActor : public AActor
{
    GENERATED_BODY()

    // Called at start of game.
    void BeginPlay();

    // Called when destroyed.
    void EndPlay(const EEndPlayReason::Type EndPlayReason);

    // Called every frame to update this actor.
    void Tick(float DeltaSeconds);
};

ブループリント :

UE4 のコンポーネントには異なる関数が含まれます。以下は単純な例です。

C++ :

UCLASS()
class UMyComponent : public UActorComponent
{
    GENERATED_BODY()

    // Called after the owning Actor was created
    void InitializeComponent();

    // Called when the component or the owning Actor is being destroyed
    void UninitializeComponent();

    // Component version of Tick
    void TickComponent(float DeltaTime, enum ELevelTick TickType, FActorComponentTickFunction* ThisTickFunction);
};

ブループリント :

UE4 では、メソッドの親クラスのバージョンを呼び出すことが重要です。

例えば、Unity の C# では、これは base.Update() で呼び出します。しかし、UE4 のC++ では、Super::TickComponent(): を使用します。

void UMyComponent::TickComponent(float DeltaTime, enum ELevelTick TickType, FActorComponentTickFunction* ThisTickFunction)
{
    // Custom tick stuff here
    Super::TickComponent(DeltaTime, TickType, ThisTickFunction);
}

C++ では、"A" で始まるものと "U" で始まるものがあることにお気づきでしょう。接頭辞 "A" は、アクタのサブクラスを表します。これに対して、 "U" は オブジェクト のサブクラスを示します。他にも接頭辞があります。例えば、 "F" は最も単純なデータ構造または-UObject クラスではないものに使用されます。

UE4 でゲームプレイコードを記述する方法

ここから少し詳しく掘り下げていきます。ゲーム制作において重要なプログラミングのトピックについて説明します。Unity をご存じであるため、Unreal Engine の C++ を学習する C# ユーザー向けに機能を説明しますが、お望みであればブループリントスクリプティングを使用してほぼすべてのことができます。可能な限り、C++ とブループリントの両方の例を加えました。

非常に一般的なゲームプレイプログラミングパターンと Unreal Engine での手法について説明します。Unity の多くの関数に対して、それに相当する馴染みのある関数が Unreal Engine にもあります。一般的な関数をひとつずつ説明していきます。

ゲームオブジェクトのインスタンス化 / アクタのスポーン

Unity では、インスタンス化する関数を使用してオブジェクトの新しいインスタンスを作成します。

この関数は任意の UnityEngine.Object 型 (GameObject、 MonoBehaviour など) を引数に取り、コピーを作ります。

public GameObject EnemyPrefab;
public Vector3 SpawnPosition;
public Quaternion SpawnRotation;

void Start()
{
    GameObject NewGO = (GameObject)Instantiate(EnemyPrefab, SpawnPosition, SpawnRotation);
    NewGO.name = "MyNewGameObject";
}

UE4 では、オブジェクトをインスタンス化するニーズに応じて異なる 2 つの関数があります。NewObject を使用して新しい UObject タイプを作成します。SpawnActor を使用して AActor タイプをスポーンします。

最初に、UObjects と NewObject について簡単に説明します。Unreal Engine で UObject をサブクラス化することは、Unity で ScriptableObject をサブクラス化するのと非常に似ています。ワールドにスポーンする必要がない、またはアクタのようにアタッチされたコンポーネントを持つゲームプレイクラスで役立ちます。

Unity では、ScriptableObject の独自のサブクラスを作成した場合、以下のようにインスタンス化できます。

MyScriptableObject NewSO = ScriptableObject.CreateInstance<MyScriptableObject>();

Unreal Engine では、独自の UObject 派生型を作成した場合、以下のようにインスタンス化できます。

UMyObject* NewObj = NewObject<UMyObject>();

アクタはどうでしょう？アクタは、World (C++ の UWorld) オブジェクトで SpawnActor メソッドを使用してスポーンされます。World オブジェクトはどのように取得しますか？一部の UObjects は、GetWorld メソッドを提供します。例えば、すべてのアクタがそうです。

別のアクタを渡す代わりに、スポーンしたいアクタの「クラス」を渡すことに注意してください。この例では、クラスは AMyEnemy の任意のサブクラスになります。

しかし、インスタンス化で可能なように、別のオブジェクトの「コピー」を作りたい場合はどうでしょう？

NewObject 関数と SpawnActor 関数も一緒に動作する「テンプレート」オブジェクトがあります。Unreal Engine では「ゼロから」作るかわりにそのオブジェクトのコピーを作ります。これにより、UPROPERTY とコンポーネントのすべてをコピーします。

AMyActor* CreateCloneOfMyActor(AMyActor* ExistingActor, FVector SpawnLocation, FRotator SpawnRotation)
{
    UWorld* World = ExistingActor->GetWorld();
    FActorSpawnParameters SpawnParams;
    SpawnParams.Template = ExistingActor;
    World->SpawnActor<AMyActor>(ExistingActor->GetClass(), SpawnLocation, SpawnRotation, SpawnParams);
}

この文脈で、「ゼロから」が何を意味するか疑問に思われるかもしれません。作成する各オブジェクトクラスはデフォルトのテンプレートを持ちます。このテンプレートには、プロパティとコンポーネントのデフォルト値があります。こうしたプロパティをオーバーライドせず、独自のテンプレートを提供しなければ、Unreal Engine はこうしたデフォルト値を使用してオブジェクトを作ります。わかりやすくするために、例えば、まず MonoBehaviour を見てみます。

public class MyComponent :MonoBehaviour
{
    public int MyIntProp = 42;
    public SphereCollider MyCollisionComp = null;

    void Start()
    {
        // Create the collision component if we don't already have one
        if (MyCollisionComp == null)
        {
            MyCollisionComp = gameObject.AddComponent<SphereCollider>();
            MyCollisionComp.center = Vector3.zero;
            MyCollisionComp.radius = 20.0f;
        }
    }
}

上の例では、デフォルトで 42 になっている int プロパティと、デフォルトで半径 20 になっている SphereCollider コンポーネントがあります。

Unreal Engine でもオブジェクトのコンストラクタを使用して同じことを行うことができます。

UCLASS()
class AMyActor : public AActor
{
    GENERATED_BODY()

    UPROPERTY()
    int32 MyIntProp;

    UPROPERTY()
    USphereComponent* MyCollisionComp;

    AMyActor()
    {
        MyIntProp = 42;

        MyCollisionComp = CreateDefaultSubobject<USphereComponent>(FName(TEXT("CollisionComponent"));
        MyCollisionComp->RelativeLocation = FVector::ZeroVector;
        MyCollisionComp->SphereRadius = 20.0f;
    }
};

AMyActor のコンストラクタで、クラスのデフォルトプロパティ値を設定しました。CreateDefaultSubobject 関数の使い方に注意してください。この関数を使用してコンポーネントを作成し、コンポーネントにデフォルトプロパティを割り当てることができます。この関数を使用して作成するすべてのサブオブジェクトはデフォルトテンプレートとして機能するため、サブクラスまたはブループリントで変更できます。

ある型から別の型へのキャスト

この場合、持っているとわかっているコンポーネントを取得し、それを特定の型にキャストし、条件付きで何かを行います。

Unity C#:

Collider collider = gameObject.GetComponent<Collider>;
SphereCollider sphereCollider = collider as SphereCollider;
if (sphereCollider != null)
{
        // ...
}

UE4 C++:

UPrimitiveComponent* Primitive = MyActor->GetComponentByClass(UPrimitiveComponent::StaticClass());
USphereComponent* SphereCollider = Cast<USphereComponent>(Primitive);
if (SphereCollider != nullptr)
{
        // ...
}

ゲームオブジェクト / アクタを破壊する


Unity	C++	ブループリント
Destroy(MyGameObject);	MyActor->Destroy();

ゲームオブジェクト / アクタを (1 秒後に) 破棄する


Unity	C++	ブループリント
Destroy(MyGameObject, 1);	MyActor->SetLifeSpan(1);	クリックして画像をフルサイズで表示

ゲームオブジェクト / アクタを無効にする


Unity	C++	ブループリント
MyGameObject.SetActive(false);	// Hides visible components `MyActor->SetActorHiddenInGame(true); // Disables collision components MyActor->SetActorEnableCollision(false); // Stops the Actor from ticking MyActor->SetActorTickEnabled(false);`	クリックして画像をフルサイズで表示

コンポーネントからゲームオブジェクト / アクタにアクセスする


Unity	C++	ブループリント
GameObject ParentGO = `MyComponent.gameObject;`	AActor* ParentActor = `MyComponent->GetOwner();`	クリックして画像をフルサイズで表示

ゲームオブジェクト / アクタからコンポーネントにアクセスする

Unity

MyComponent MyComp = gameObject.GetComponent<MyComponent>();

C++

UMyComponent* MyComp = MyActor->FindComponentByClass<UMyComponent>();

Blueprint

ゲームオブジェクト / アクタの検索

// Find GameObject by name
GameObject MyGO = GameObject.Find("MyNamedGameObject");

// Find Objects by type
MyComponent[] Components = Object.FindObjectsOfType(typeof(MyComponent)) as MyComponent[];
foreach (MyComponent Component in Components)
{
        // ...
}

// Find GameObjects by tag
GameObject[] GameObjects = GameObject.FindGameObjectsWithTag("MyTag");
foreach (GameObject GO in GameObjects)
{
        // ...
}

// Find Actor by name (also works on UObjects)
AActor* MyActor = FindObject<AActor>(nullptr, TEXT("MyNamedActor"));

// Find Actors by type (needs a UWorld object)
for (TActorIterator<AMyActor> It(GetWorld()); It; ++It)
{
        AMyActor* MyActor = *It;
        // ...
}

// Find UObjects by type
for (TObjectIterator<UMyObject> It; It; ++It)
{
    UMyObject* MyObject = *It;
    // ...
}

// Find Actors by tag (also works on ActorComponents, use TObjectIterator instead)
for (TActorIterator<AActor> It(GetWorld()); It; ++It)
{
    AActor* Actor = *It;
    if (Actor->ActorHasTag(FName(TEXT("Mytag"))))
    {
        // ...
    }
}

GameObject / アクタにタグを追加する

MyGameObject.tag = "MyTag";

// Actors can have multiple tags
MyActor.Tags.AddUnique(TEXT("MyTag"));

MonoBehaviour / ActorComponent にタグを追加する

// This changes the tag on the GameObject it is attached to
MyComponent.tag = "MyTag";

// Components have their own array of tags
MyComponent.ComponentTags.AddUnique(TEXT("MyTag"));

GameObject / アクタと MonoBehaviour / ActorComponent でタグを比較する

if (MyGameObject.CompareTag("MyTag"))
{
    // ...
}

// Checks the tag on the GameObject it is attached to
if (MyComponent.CompareTag("MyTag"))
{
    // ...
}

// Checks if an Actor has this tag
if (MyActor->ActorHasTag(FName(TEXT("MyTag"))))
{
    // ...
}

// Checks if an ActorComponent has this tag
if (MyComponent->ComponentHasTag(FName(TEXT("MyTag"))))
{
    // ...
}

物理 RigidBody と Primitive コンポーネント

Unity では、ゲームオブジェクトに物理特性を与えるために、まず RigidBody コンポーネントを追加します。Unreal Engine では、任意の Primitive コンポーネント (C++ では UPrimitiveComponent ) が物理オブジェクトになります。一般的な Primitive コンポーネントとして、ShapeComponents (カプセル、球、ボックス)、StaticMeshComponent、および SkeletalMeshComponent があります。

Unity とは異なります。Unity では、コリジョンとビジュアル化の役割は別のコンポーネントに分かれています。Unreal Engine では、物理とビジュアルの概念を PrimitiveComponent に組み合わせています。ワールドでジオメトリを持つコンポーネントはレンダリングされるか、PrimitiveComponent のサブクラスと物理的に相互作用します。

レイヤー vs チャンネル

Unity では、「レイヤー」と呼ばれます。UE4 では、コリジョンチャンネルを使用し、同様に機能します。こうした情報については、こちらを参照してください。

レイキャスト vs レイトレース

Unity C#:

GameObject FindGOCameraIsLookingAt()
{
    Vector3 Start = Camera.main.transform.position;
    Vector3 Direction = Camera.main.transform.forward;
    float Distance = 100.0f;
    int LayerBitMask = 1 << LayerMask.NameToLayer("Pawn");

    RaycastHit Hit;
    bool bHit = Physics.Raycast(Start, Direction, out Hit, Distance, LayerBitMask);

    if (bHit)
    {
        return Hit.collider.gameObject;
    }

    return null;
}

UE4 C++:

APawn* AMyPlayerController::FindPawnCameraIsLookingAt()
{
    // You can use this to customize various properties about the trace
    FCollisionQueryParams Params;
    // Ignore the player's pawn
    Params.AddIgnoredActor(GetPawn());

    // The hit result gets populated by the line trace
    FHitResult Hit;

    // Raycast out from the camera, only collide with pawns (they are on the ECC_Pawn collision channel)
    FVector Start = PlayerCameraManager->GetCameraLocation();
    FVector End = Start + (PlayerCameraManager->GetCameraRotation().Vector() * 1000.0f);
    bool bHit = GetWorld()->LineTraceSingle(Hit, Start, End, ECC_Pawn, Params);

    if (bHit)
    {
        // Hit.Actor contains a weak pointer to the Actor that the trace hit
        return Cast<APawn>(Hit.Actor.Get());
    }

    return nullptr;
}

UE4 ブループリント:

クリックして画像をフルサイズで表示

トリガー

Unity C#:

public class MyComponent :MonoBehaviour
{
    void Start()
    {
        collider.isTrigger = true;
    }
    void OnTriggerEnter(Collider Other)
    {
        // ...
    }
    void OnTriggerExit(Collider Other)
    {
        // ...
    }
}

UE4 C++:

UCLASS()
class AMyActor : public AActor
{
    GENERATED_BODY()

    // My trigger component
    UPROPERTY()
    UPrimitiveComponent* Trigger;

    AMyActor()
    {
        Trigger = CreateDefaultSubobject<USphereComponent>(TEXT("TriggerCollider"));

        // Both colliders need to have this set to true for events to fire
        Trigger.bGenerateOverlapEvents = true;

        // Set the collision mode for the collider
        // This mode will only enable the collider for raycasts, sweeps, and overlaps
        Trigger.SetCollisionEnabled(ECollisionEnabled::QueryOnly);
    }

    virtual void NotifyActorBeginOverlap(AActor* Other) override;

    virtual void NotifyActorEndOverlap(AActor* Other) override;
};

UE4 ブループリント:

コリジョン応答の設定についての詳しい情報については、こちらを参照してください。

キネマティックリジッドボディ

Unity C#:

public class MyComponent :MonoBehaviour
{
    void Start()
    {
        rigidbody.isKinimatic = true;
        rigidbody.velocity = transform.forward * 10.0f;
    }
}

UE4 では、コリジョンコンポーネントと rigidbody (剛体) コンポーネントはひとつです。これに対する基本クラスは、UPrimitiveComponent であり、ニーズに合うように多くのサブクラスがあります (USphereComponent、 UCapsuleComponent など)。

UE4 C++:

UCLASS()
class AMyActor : public AActor
{
    GENERATED_BODY()

    UPROPERTY()
    UPrimitiveComponent* PhysicalComp;

    AMyActor()
    {
        PhysicalComp = CreateDefaultSubobject<USphereComponent>(TEXT("CollisionAndPhysics"));
        PhysicalComp->SetSimulatePhysics(false);
        PhysicalComp->SetPhysicsLinearVelocity(GetActorRotation().Vector() * 100.0f);
    }
};

入力イベント

Unity C#:

public class MyPlayerController :MonoBehaviour
{
    void Update()
    {
        if (Input.GetButtonDown("Fire"))
        {
            // ...
        }
        float Horiz = Input.GetAxis("Horizontal");
        float Vert = Input.GetAxis("Vertical");
        // ...
    }
}

UE4 C++:

UCLASS()
class AMyPlayerController : public APlayerController
{
    GENERATED_BODY()

    void SetupInputComponent()
    {
        Super::SetupInputComponent();

        InputComponent->BindAction("Fire", IE_Pressed, this, &AMyPlayerController::HandleFireInputEvent);
        InputComponent->BindAxis("Horizontal", this, &AMyPlayerController::HandleHorizontalAxisInputEvent);
        InputComponent->BindAxis("Vertical", this, &AMyPlayerController::HandleVerticalAxisInputEvent);
    }

    void HandleFireInputEvent();
    void HandleHorizontalAxisInputEvent(float Value);
    void HandleVerticalAxisInputEvent(float Value);
};

UE4 ブループリント:

以下は、Project Settings (プロジェクト設定) で入力プロパティがどのように見えるかを表しています。

入力のセットアップ方法の詳しい情報は、こちらを参照してください。

FAQ

最後に作業したプロジェクトを自動的にロードする方法は？

Unity で最後に作業したプロジェクトを自動的にロードすることに慣れている場合、UE4 でも同じようにできます。これを有効にするには、プロジェクトを開くときに、 "Always load last project on Startup" (最後に使用したプロジェクトを起動時に常にロードする) にチェックを入れてください。メインの Edit メニューの Edit/Editor Preferences/Loading と Saving/Startup で、いつでも設定を切り替えることができます。

ゲームの入力バインディングをどこで設定したらよいですか？

Unity では、プロジェクトの Input Manager 設定を使用してデフォルトバインディングをセットアップしています。UE4 も同じようにできます。Project Settings (プロジェクト設定) を開いて、Input カテゴリを選択します。ここでは、様々なボタン (アクション) やアナログコントロール (軸) を追加することができます。各コントロールに名前とデフォルトバインディングを与えます。入力イベントがトリガーされるとゲームのポーンをコールバックします。詳細については「入力を参照してください。

プロジェクトの開始シーンの変更方法は？

プロジェクトの設定タブからプロジェクトのスタートアップマップを変更できます。メインメニューから Edit/Project Settings->Maps & Modes の順に選択してスタートアップマップを変更します。

ゲームを実行する方法は？

ゲームを実行する一番簡単な方法は、メインエディタのツールバーで [Play] ボタンをクリックすることです。これで、エディタのプロセス内でゲームを実行します。スタンドアロンのアプリケーションとして実行したい場合は、[Play] ボタンの隣にあるドロップダウンの矢印をクリックして、「Standalone Game」を選択します。最後に、モバイルデバイスまたはウェブブラウザで実行したい場合、ツールバーの [Launch] ボタンを使用します (プラットフォームで事前に必要なものをインストール後)。

単位は？

Unity では、計測の基本単位は 1 m です。UE4 では、計測の基本単位は 1 cm です。

そのため、Unity で何かを 1 単位 (m) 動かすと、UE4 で何かを 100 単位(cm) 動かすことに相当します。

Unity で何かを 2 フィート動かすと 0.61 単位 (メーター) になり、UE4 では 61 単位 (cm) になります。

座標系はどのようになっていますか？

Unity と UE4 は両方とも左手座標系ですが、軸は入れ替わっています。UE4では+ X 軸は「前」で、+ Y 軸は「右」、+ Z 軸は「上」になっています。

どうしたらゲームからログの出力が見ることができますか？

UE4 エディタでは、 "Window -> Developer Tools" メニューから Output Log を開くことができます。ゲームを "-log" コマンドラインパラメータで実行し、ゲームの横に専用ログウィンドウを呼び出すことができます。これはとても便利です。

ログ出力といえば、Debug.Log はどこにあるのでしょう？

UE4 のロギングは高度なカスタマイズが可能です。メッセージのログをとる方法については、こちらを参照してください。

例外のスローはどのように行うのでしょうか？

Unity では、何かがうまくいかないときに例外をスローしていました。UE4 では、例外処理を使用しません。代わりに、'check()' 関数を使用してクリティカルなアサーションエラーをトリガーします。エラーメッセージを渡すことができます。エラーを報告したいが、プログラムを停止したくない場合は、代わりに 'ensure()' を使用します。これで、完全なコールスタックをログに出力しますが、プログラムは実行され続けます。デバッガーをアタッチすると、両方の関数はデバッガでブレークします。

.NET フレームワークはどこですか？

Unity とは異なり、UE4 では .NET フレームワークを使用しません。UE4 には独自のコンテナクラスとライブラリのセットがあります。一般的なコンテナの比較です。


.Net Framework	UE4
String	FString , FText
List	TArray
Dictionary	TMap
HashSet	TSet

その他の UE4 コンテナの詳しい情報については Containersこちらを参照してください。

Unreal Engine ではコード変更を自動的にリロードしますか？

します。コードを記述中にエディタを開いたままにすることができます。コード編集後に Visual Studio からコンパイルを開始すると、エディタは変更を自動的に「ホットリロード」します。エディタのメインツールバーで コンパイル ボタンをクリックすることもできます。これは、Visual Studio のデバッガをアタッチした場合に役立ちます。

ここから先のこと

ガイドをお読みいただきありがとうございます。本ガイドは、アンリアルコミュニティ向けに多くのデベロッパーの支援により作成されたものです。フィードバックや訂正があればご指摘いただければ幸いです。UE4 へ移行するために最も役立つ情報を検討し、お引越しガイドを改善し続けます。

これ以外にも、以下のように多くの UE4 学習リソースをご用意しております。

ドキュメント
- まずはここから - 入門ガイド
チュートリアルビデオ - ビデオ
API - API
AnswerHub - https://answers.unrealengine.com
フォーラム - https://forums.unrealengine.com
Wiki - https://wiki.unrealengine.com
- Wiki ページの UE4 coming from Unity

タグ

unity

Unreal Engine のドキュメントを改善するために協力をお願いします！どのような改善を望んでいるかご意見をお聞かせください。

調査に参加する

閉じる

Unity 引っ越しガイド

Unity の操作内容を UE4 の該当する部分と比較して説明し、UE4 の迅速な習得を支援します。

エディタ

アセットの編集

クイック用語集

プロジェクトとファイル

ディレクトリやファイルは？

アセットを入れる場所は？

サポートされる共通ファイル形式は？

シーンの保存方法は？

プロジェクト設定の変更方法は？

ソース ファイルの行先は？

GameObjects からアクタへ

GameObject はどこに？

コンポーネントはどこに？

Unity のプレハブから UE4 のブループリント クラスへ

スクリプト コンポーネントと MonoBehaviour はどこに？

スクリプト可能な Actor ブループリント クラス

UE4 のブループリント クラスは拡張可能

ブループリント スクリプティング、C++ のいずれかを使用、または両方使用するのか？

ブループリント クラスは C++ クラスを拡張可能

Transform コンポーネント

複合オブジェクト

コンポーネントから何もかもビルドするのでしょうか？

何もかもがアクタということでしょうか？

UE4 のゲームプレイ フレームワークはどのようなものですか？

UE4 でコードを記述する方法

MonoDevelop プログラマー向け

イベント関数 (Start、Update、など) の記述

UE4 でゲームプレイ コードを記述する方法

ゲームオブジェクトのインスタンス化 / アクタのスポーン

ある型から別の型へのキャスト

ゲームオブジェクト / アクタを破壊する

ゲームオブジェクト / アクタを (1 秒後に) 破棄する

ゲームオブジェクト / アクタを無効にする

コンポーネントからゲームオブジェクト / アクタにアクセスする

ゲームオブジェクト / アクタからコンポーネントにアクセスする

ゲームオブジェクト / アクタの検索

GameObject / アクタにタグを追加する

MonoBehaviour / ActorComponent にタグを追加する

GameObject / アクタと MonoBehaviour / ActorComponent でタグを比較する

物理 RigidBody と Primitive コンポーネント

レイヤー vs チャンネル

レイキャスト vs レイトレース

トリガー

キネマティック リジッドボディ

入力イベント

FAQ

最後に作業したプロジェクトを自動的にロードする方法は？

ゲームの入力バインディングをどこで設定したらよいですか？

プロジェクトの開始シーンの変更方法は？

ゲームを実行する方法は？

単位は？

座標系はどのようになっていますか？

どうしたらゲームからログの出力が見ることができますか？

ログ出力といえば、Debug.Log はどこにあるのでしょう？

例外のスローはどのように行うのでしょうか？

.NET フレームワークはどこですか？

Unreal Engine ではコード変更を自動的にリロードしますか？

ここから先のこと

ソースファイルの行先は？

Unity のプレハブから UE4 のブループリントクラスへ

スクリプトコンポーネントと MonoBehaviour はどこに？

スクリプト可能な Actor ブループリントクラス

UE4 のブループリントクラスは拡張可能

ブループリントスクリプティング、C++ のいずれかを使用、または両方使用するのか？

ブループリントクラスは C++ クラスを拡張可能

UE4 のゲームプレイフレームワークはどのようなものですか？

UE4 でゲームプレイコードを記述する方法

キネマティックリジッドボディ