この記事では、Unreal Engine (UE) ゲーム サンプルをダウンロードし、Visual Studio Tools for Unreal Engine を構成します。 Visual Studio Tools for Unreal Engine は、Unreal Engine を使用してゲームを開発するのに役立つ無料の拡張機能です。 Visual Studio の Unreal Engine 開発エクスペリエンスを向上させる機能を提供します。
[前提条件]
以下をインストールする必要があります。
- Visual Studio バージョン 17.10 以降。
- この記事で使用する例では Unreal Engine 5 以降が必要であるため、Unreal Engine バージョン 5 以降。
- Visual Studio Tools for Unreal Engine。 インストール手順については、「 Visual Studio Tools for Unreal Engine のインストール」を参照してください。
Visual Studio で Lyra ゲーム サンプルをダウンロードしてビルドする
Lyra は、Unreal Engine について学習するためのサンプル ゲーム プロジェクトです。 ダウンロード手順については、Lyra サンプル ゲームの「Lyra Starter Game のダウンロード」セクションを参照してください。 Unreal Engine のソース コード インストールを使用して入手した場合、そのバージョンには、ゲームのビルドと実行に必要なアセットは含まれません。 ダウンロード手順を使用して、Epic インストーラーを使用して必要なすべてを取得します。
Visual Studio Tools for Unreal Engine を使用するように Lyra ゲーム サンプルを構成する
Visual Studio 2022 バージョン 17.7 以降、Visual Studio Tools for Unreal Engine プラグインは Unreal Engine のインストールに含まれています。 Unreal Engine ブループリントを表示する必要がなくなりました。 以前のバージョンの Visual Studio をお持ちの場合は、「 Visual Studio Tools for Unreal Engine をインストール してプラグインを手動でインストールする」を参照してください。
ゲーム サンプルをダウンロードしたら、Visual Studio Tools プラグインを使用するように LyraStarterGame.uproject を更新します。 これを行う 1 つの方法は、Unreal Editor です。 Lyra プロジェクトを読み込み、メイン メニューから >] を選択します。
Visual Studio Integration Tools プラグインを見つけて、その横にあるチェック ボックスをオンにします。
別の方法は、 LyraStarterGame.uproject ファイルを手動で編集することです。 その方法は次のとおりです。
テキスト エディターで
LyraStarterGame.uprojectファイルを開きます。 これは、ゲーム サンプルをインストールしたディレクトリにあります。Pluginsセクションの末尾に次のコードを追加します。,{ "Name": "VisualStudioTools", "Enabled": true }
Unreal Engine の場合
- Unreal Engine で Lyra プロジェクトを開きます。
- Unreal Engine エディターのメイン メニューで、[ツール] >Generate Visual Studio Project を選択します。 これにより、Visual Studio のソリューション ファイルが作成されます。
- Unreal Engine エディターのメイン メニューで、[ツール] を選択>Visual Studio を開いて Visual Studio でゲームを開きます。 コンピューターに複数のバージョンの Visual Studio がある場合は、適切なバージョンが開かれていることを確認します。Visual Studio のメイン メニューから[ヘルプ]、[Microsoft Visual Studio について>を選択します。 Visual Studio 2022 バージョン 17.7 以降を使用する必要があります。 適切なバージョンが開いていない場合は、適切なバージョンの Visual Studio で
LyraStarterGame.slnを手動で開きます。
Visual Studio で
- [ソリューション構成] ドロップダウンを開発エディターに変更します。 これにより、Blueprints Visual Studio Tools for Unreal Engine:
- スタートアップ プロジェクトを LyraStarterGame プロジェクトに設定します。 ソリューション エクスプローラーで、ソリューションを右クリックし、[プロパティ] を選択します。
- [ ソリューション プロパティ ページ ] ダイアログの [ 共通プロパティ] で、[ スタートアップ プロジェクトの構成] を選択します。
-
[単一スタートアップ プロジェクト] が選択されていることを確認し、ドロップダウンで [LyraStarterGame] を選択します。
[共通プロパティ] の [スタートアップ プロジェクトの構成] が選択されています。 [1 つのスタートアップ プロジェクト] ラジオ ボタンが選択されています。 ドロップダウンのスタートアップ プロジェクトは LyraStarterGame です。
- [ OK] を 選択してダイアログを閉じます。
- Visual Studio のメイン メニューから[ ビルド>ビルド ソリューション ]を選択してゲームをビルドします。
Visual Studio のビルド出力ウィンドウ
Visual Studio のビルド出力ウィンドウには、ビルドの進行状況と発生したエラーまたは警告が表示されます。 Visual Studio のメイン メニューから、 ビュー>Output を使用してビルド出力ウィンドウを開くことができます。
Visual Studio 2022 17.12 以降では、出力ウィンドウでファイルへの絶対パスをダブルクリックして、Visual Studio でそのファイルを開くことができます。 ソース コードは Visual Studio ソリューションの一部である必要があり、出力ウィンドウのパスは絶対パスである必要があります。 これは、Visual Studio またはその他の種類のプロジェクトで Unreal Engine プロジェクトをビルドするときに機能します。
次のスクリーンショットは、LyraStarterGame サンプルのビルドの出力ウィンドウを示しています。 ユーザーが LyraCharacter.generated.hからの警告をダブルクリックしました。 そのファイルへの絶対パスが指定されているため、ファイルがエディターで開きます。
Unreal Engine ツール バー
Visual Studio には、Visual Studio での Unreal Engine 開発統合エクスペリエンスを向上させるツール バーが用意されています。 ツール バーを使用すると、一般的な UE タスクにすばやくアクセスできます。
View>Toolbars>Unreal Engine を使用して、Visual Studio の Unreal Engine ツール バーをアクティブにします。 ツール バーは次のようになります。
ツール バー ボタン (左から右):
- 再生アイコンは、右側のドロップダウンリストに表示されているプロセスにアタッチするクイックアタッチボタンです。 ドロップダウンリストには Unreal Engine 関連のプロセスが一覧表示されるため、Unreal Engine Editor へのアタッチがより簡単になります。 これを使用して、任意のプロセスにアタッチすることもできます。
- Unreal Engine 統合サーバーを起動および停止するためのボタン。 統合サーバーにより、Visual Studio との Unreal Engine 統合のパフォーマンスが向上します。 バックグラウンド プロセスとして実行され、プロジェクトで作業するときにテスト情報が自動的に更新されます。 これをオフにすると、マシン リソースを再利用し、統合の改善が必要になったときに開始できます。 Visual Studio で UE プロジェクトを開くと、サーバーが自動的に起動します。
- Unreal Engine Blueprint アセットを再スキャンするためのボタン。 これにより、Unreal Engine プロジェクトの最新のブループリント アセットで Visual Studio ソリューションが更新されます。
- Unreal Engine ログ ウィンドウを開くボタン。
- Unreal Engine Integration Configuration ウィンドウを開くボタン。ここで、構成の全体的な状態と Visual Studio 統合ツールの状態を更新して確認したり、ブループリントのサポートを確認したり、Unreal Engine の名前付け規則チェッカーの状態を取得するかどうかを確認したりできます。
コマンド ライン引数のドロップダウン
内部ループの編集とデバッグの部分では、コマンド ライン引数の組み合わせが異なるゲームを頻繁に起動することがあります。 コマンドライン引数のドロップダウンを使用すると、次の操作が簡単になりました。
[標準] ツール バーの [ソリューション プラットフォーム] ドロップダウンの下に、コマンド ライン引数のドロップダウンが表示されます。 C:\UE\LyraStarterGame\LyraStarterGame.uproject -fullscreen と C:\UE\LyraStarterGame\LyraStarterGame.uproject -JsonDebugOutput のエントリがあります。
コマンド ライン引数を追加するには、ドロップダウンに引数を入力し、 Enter キーを押します。 引数は入力した順序で保存され、後で使用できるようにドロップダウンに表示されます。
最も古いものが削除される前に追加できるコマンド ラインは 5 行に制限されており、新しいコマンド ライン用のスペースを作ることができます。 Unreal Engine を初めて読み込むと、既定の引数がドロップダウンに表示されます。
Unreal Engine エディターで実行される Unreal Engine プロジェクトをデバッグするときの最初の引数は、プロジェクトへのパスである必要があります。 たとえば、 C:\UE\LyraStarterGame\LyraStarterGame.uprojectと指定します。
コマンド ライン引数ドロップダウンの使用方法の詳細については、「コマンド ライン引数を渡す」を参照してください。
次のステップ
Visual Studio で Unreal Engine のクラス、モジュール、プラグインを追加する
Visual Studio で Unreal Engine ブループリントを表示する
Visual Studio で Unreal Engine のログ記録を表示する
Visual Studio で Unreal Engine マクロを表示する