次の方法で共有

クイック スタート: Visual Studio Tools for Unreal Engine

  • [アーティクル]

この記事では、Unreal Engine (UE) ゲーム サンプルをダウンロードし、Unreal Engine 用に Visual Studio Tools を構成します。 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 Sample Game の「Downloading the Lyra Starter Game」 (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 統合ツール プラグインを見つけて、その横にあるチェック ボックスをオンにします。

LyraStarterGame.uproject ファイルを手動で編集する方法もあります。 方法は以下のとおりです。

  1. テキスト エディターで LyraStarterGame.uproject ファイルを開きます。 これは、ゲーム サンプルをインストールしたディレクトリにあります。

  2. Plugins セクションの末尾に次を追加します。

    ,{
    "Name": "VisualStudioTools",
    "Enabled": true
}

Unreal Engine

  1. Unreal Engine で Lyra プロジェクトを開きます。
  2. Unreal Engine エディタのメイン メニューから、 [ツール]>[Visual Studio プロジェクトの生成]を選択します。 これにより、Visual Studio のソリューション ファイルが作成されます。
  3. Unreal Engine エディタのメイン メニューから、 [ツール]>[Visual Studio を開く] を選択して、Visual Studio でゲームを開きます。 コンピューターに複数のバージョンの Visual Studio がある場合は、Visual Studio のメイン メニューから、[ヘルプ]>[Microsoft Visual Studio のバージョン情報] を選択して、適切なバージョンが開かれていることを確認します。 Visual Studio 2022 バージョン 17.7 以降を使用する必要があります。 適切なバージョンが開いていない場合は、正しいバージョンの Visual Studio で LyraStarterGame.sln を手動で開きます。

Visual Studio で

  1. [ソリューション構成] ドロップダウンを [開発エディター] に変更します。 これにより、ブループリント Visual Studio Tools for Unreal Engineが有効になります。ソリューション構成ドロップダウンが展開され、開発エディターが選択された Visual Studio のスクリーンショット。
  2. スタートアップ プロジェクトを LyraStarterGame プロジェクトに設定します。 ソリューション エクスプローラーでソリューションを右クリックし、[プロパティ] を選択します。
  3. [ソリューション プロパティ ページ] ダイアログの [共通プロパティ]で [スタートアップ プロジェクトの構成] を選択します。
  4. [シングル スタートアップ プロジェクト] が選択されていることを確認し、ドロップダウンで [LyraStarterGame] を選択します。

    [ソリューション プロパティ ページ] のスクリーンショット。

  5. [OK] を選択してダイアログを閉じます。
  6. Visual Studio のメイン メニューから、[ビルド]>[ソリューションのビルド] を選択してゲームをビルドします。

Visual Studio のビルド出力ウィンドウ

Visual Studio のビルド出力ウィンドウには、ビルドの進行状況と発生したエラーや警告が表示されます。 Visual Studio のメイン メニューから 表示>出力を選択して、ビルド出力ウィンドウを開くことができます。

Visual Studio 2022 17.12 以降では、出力ウィンドウでファイルへの絶対パスをダブルクリックして、そのファイルを Visual Studio で開くことができます。 ソース コードは Visual Studio ソリューションの一部である必要があり、出力ウィンドウ内のパスは絶対パスである必要があります。 これは、Visual Studio またはその他の種類のプロジェクトで Unreal Engine プロジェクトをビルドするときに機能します。

次のスクリーンショットは、LyraStarterGame サンプルのビルドの出力ウィンドウを示しています。 ユーザーは LyraCharacter.generated.h からの警告をダブルクリックしました。 そのファイルへの絶対パスが提供されているため、エディターでファイルが開きます。

Visual Studio 出力ウィンドウのスクリーンショット。絶対パスが指定されており、ユーザーがダブルクリックして LyrCharacter.generated.h ファイルを開いたため、LyraCharacter.generated.h ファイルが強調表示されています。

Unreal Engine ツールバー

Visual Studio には、Visual Studio での Unreal Engine 開発統合エクスペリエンスを向上させるツールバーが用意されています。 ツールバーを使用すると、一般的な UE タスクにすばやくアクセスできます。

Visual Studio のメイン メニューから [表示]>[ツールバー]>[Unreal Engine]を選択して、Unreal Engine ツールバーをアクティブにします。 ツールバーは次のようになります。

Visual Studio の Unreal Engine ツールバーのスクリーンショット。

ツールバーのボタン、左から右:

  • 再生アイコンは、右側のドロップダウンにリストされているプロセスに接続するクイック接続ボタンです。 ドロップダウンには Unreal Engine 関連のプロセスがリストされるため、Unreal Engine エディタへの接続がより簡単になります。 これを使用して任意のプロセスにアタッチすることもできます。
  • Unreal Engine 統合サーバーを起動および停止するためのボタン。 統合サーバーは、Unreal Engine と Visual Studio の統合のパフォーマンスを向上させます。 これはバックグラウンド プロセスとして実行され、プロジェクトの作業中にテスト情報が自動的に更新されます。 マシンのリソースを再利用するためにこれをオフにし、統合の改善が必要なときに起動することができます。 Visual Studio で UE プロジェクトを開くと、サーバーが自動的に起動します。
  • Unreal Engine ブループリント アセットを再スキャンするためのボタン。 これにより、Unreal Engine プロジェクトの最新のブループリント アセットを使用して Visual Studio ソリューションが更新されます。
  • Unreal Engine ログ ウィンドウを開くボタン。
  • Unreal Engine 統合構成 ウィンドウを開くボタン。このウィンドウでは、全体的な構成ステータスと Visual Studio 統合ツール ステータスを更新して確認したり、ブループリントのサポートを確認したり、Unreal Engine 命名規則チェッカー ステータスを取得しているかどうかを確認したりすることができます。

コマンド ライン引数のドロップダウン

内部ループの編集とデバッグの部分では、コマンド ライン引数の組み合わせが異なるゲームを頻繁に起動することがあります。 コマンドライン引数のドロップダウンを使用すると、次の操作が簡単になりました。

コマンド ライン引数ドロップダウンのスクリーンショット。

コマンド ライン引数を追加するには、ドロップダウンに引数を入力し、 Enter キーを押します。 引数は入力した順序で保存され、後で使用できるようにドロップダウンに表示されます。

最も古いものが削除される前に追加できるコマンド ラインは 5 行に制限されており、新しいコマンド ライン用のスペースを作ることができます。

Unreal Engine エディターで実行される Unreal Engine プロジェクトをデバッグするときの最初の引数は、プロジェクトへのパスである必要があります。 (例: C:\UE\LyraStarterGame\LyraStarterGame.uproject)。

コマンド ライン引数ドロップダウンの使用の詳細については、「デバッグ中にコマンド ライン引数を使用する (C++)」を参照してください。

次のステップ

Visual Studio に Unreal Engine のクラス、モジュール、プラグインを追加する
Visual Studio で Unreal Engine ブループリントを表示する
Visual Studio で Unreal Engine のログを表示する
Visual Studio で Unreal Engine マクロを表示する