Unreal Engine でのマルチユーザー編集入門 | Unreal Engine 5.0 ドキュメンテーション

クイックスタートページではマルチユーザー編集システムを起動し、基本機能を実行します。このチュートリアルでは、以下の習得を目指します。

複数のコンピュータからセッションに参加するための設定方法
セッションを管理するサーバーの開始方法
チームメンバーと共同作業をするためのセッションの開始および参加方法
ローカルコンピュータでセッションで作業中に行った変更をプロジェクトコンテンツで維持する方法

前提条件： このチュートリアルは、Unreal Editor の複数インスタンスを使って同じホストで実行できますが、複数の別々のコンピュータから同じセッションに接続する方がはるかに効果的です。開始方法

各コンピュータに同じバージョンの Unreal Engine をインストールします。
すべてのコンピュータが同じローカルエリアネットワーク (LAN) または仮想プライベートネットワーク (VPN) に接続されていることを確認します。

この手順の画像は Epic Games Launcher の [マーケットプレイス] タブから取得できる Third Person Template サンプルプロジェクトを使用します。ただし、使用する Unreal Engine プロジェクトにはすべて同じステップを使用できます。

1 - プラグインをアクティベートする

共有セッションで共同作業をするためには、Unreal Editor の複数インスタンスに接続する前に、プロジェクトで マルチユーザー編集 プラグインを有効にする必要があります。

Unreal Editor でプロジェクトを開きます。
メインメニューから [Edit (編集)] > [Plugins (プラグイン)] を選択します。
[Editor (エディタ)] カテゴリで [Multi-User Editing (マルチユーザー編集)] プラグインを見つけ、[Enabled (有効)] チェックボックスをオンにします。
確認画面で [Yes (はい)] をクリックします。
[Restart Now (すぐに再起動)] をクリックしてプロジェクトを再起動し、変更を適用します。

2 - 複数のコンピュータをセットアップする

同じマルチユーザー編集セッションに接続する各コンピュータに同じバージョンの Unreal Engine をインストールする必要があります。

各コンピュータにコンテンツがまったく同じである Unreal Engine プロジェクトのコピーが配置されている必要もあります。

一般的な方法として、Perforce、Git、Subversion などのバージョンコントロールシステムにプロジェクトを保存し、すべてのコンピュータで同じリビジョンまたは変更リストに同期します。

Perforce を使用している場合、UnrealGameSync (UGS) を使用してこのプロセスを簡単にすることもできます。詳細は UGS のドキュメントをご参照ください。
マルチユーザー編集システムでは、ソースコントロールの使用は必須ではありません。1 台のコンピュータから同じセッションに参加する他のすべてのコンピュータにプロジェクトフォルダをコピーするだけです。マルチユーザー編集システムの初期テストではこれで十分です。ただし、このアプローチは初期テストのみとしてください。チーム内でバージョンコントロールを効果的に使用することが、プロジェクトコンテンツを最も安全に維持共有する方法です。

各コンピュータにプロジェクトをコピーしたら、いくつかの設定をカスタマイズします。各コンピュータで以下を実行します。

Unreal Editor でプロジェクトを開き、メインメニューから [Edit (編集)] > [Project Settings... (プロジェクト設定...)] を選択します。

[Project Settings (プロジェクト設定)] ウィンドウで、[Plugins (プラグイン)] > [Multi-User Editing (マルチユーザー編集)] セクションを開きます。

次の設定を変更して、セッションへ接続している間にショートカットボタンをエディタ UI に追加し、各 Unreal Editor インスタンスで他のインスタンスに表示するプレゼンス情報をカスタマイズします。

設定	説明
Enable Multi-User Toolbar Button	Unreal Editor のメインウィンドウのツールバーに、使用頻度の高いマルチユーザー編集コマンドのショートカットボタンを追加します。
Display Name	対象コンピュータのセッション履歴とプレゼンス情報を表示するときにマルチユーザー編集システムが使用する名前を設定します。デフォルトでは、マルチユーザー編集システムはホストオペレーティングシステムの現在のユーザーログイン情報を使用します。ただし、複数のコンピュータに同じユーザーアカウントでログインするなどの場合は、この値をオーバーライドできます。
Avatar Color	プレゼンス情報とセッション履歴を表示するときに、対象コンピュータにマルチユーザー編集システムが関連付ける色を設定します。この色はデフォルトではすべてのユーザーが同色 (白) ですが、コンピュータごとに異なる色を割り当てると、自分のセッション履歴をが簡単に分かるようになります。

このパネルで使用できる設定については、「マルチユーザー編集リファレンス」を参照してください。

新しい設定を有効にするためにエディタを再起動します。

3 - サーバーを開始する

互いに接続する各コンピュータで Unreal Editor でプロジェクトを開く場合、これらのコンピュータで共有するセッションを管理するためにサーバーを開始する必要があります。一番簡単な実行方法は、これらの Unreal Editor インスタンスのいずれかで開始することです。

ツールバーの [Multi-User Editing] アイコンをクリックします。(セッションには接続されていないことを示す「Browse」となっているはずです)
Multi-User Browser ウィンドウが開きます。このパネルから、マルチユーザー編集システムでの作業に必要なほとんどのセッション管理ツールへアクセスできます。このウィンドウを頻繁に使うことになります。

ツールバーアイコンをアクティブにしていない場合でも、Window > Developer Tools > Multi-User Browser をクリックすることで、いつでもこのパネルを開くことができます。
Multi-User Browser ウィンドウで、ツールバーの一番左側にある [Launch] アイコンをクリックして、コンピューター上でマルチユーザー編集システムを起動します。
新しいコマンドウィンドウが開きます。プロジェクトコンテンツに変更を加えたときやセッションを管理しているときに、サーバーは定期的にステータスメッセージをこのウィンドウに出力します。例：

Unreal Engine がインストールされているコンピュータでコマンドラインからサーバーを起動することもできます。詳細については、「マルチユーザー編集リファレンス」ページのUnrealMultiUserServer コマンドラインパラメータセクションを参照してください。

4 - セッションを開始する

コンピュータのいずれかでサーバーが動作していますが、Unreal Editor インスタンスはどれもまだサーバーに接続されていません。これを実行するには、新しいセッションを作成する必要があります。すべての接続ユーザーがプロジェクトのアセットとレベルに加えた変更をセッションが管理し共有します。

新規セッションを作成する方法

ご使用のコンピュータの 1 つで [Multi-User Browser] ウィンドウを前のセクションで示したように開きます。

ここではセッションがまだリストされていません。しかし、サーバーが動作しているコンピュータが、この Unreal Editor のインスタンスが動作しているコンピュータからネットワークを通じて認識できる限り、新しいセッションを作成できます。
[Multi-User Browser] ウインドウのツールバーの Create a New Session アイコンをクリックします。

リストビューに新しいセッションを設定するための行が追加されています。
新しいセッションの名前を入力し、ドロップダウンリストからセッションを管理するサーバーを選択します。(今現在、このリストで選択できるサーバーは 1 つだけです)次に、一番→のチェックボックスアイコンを選択してセッションを作成します。

Unreal Editor が動作しているコンピュータが同じ LAN または VPN にあるにもかかわらず、新しいセッションを作成できない、もしくはサーバーが サーバー ドロップダウンリストに表示されない場合、この時点で中断して、追加のネットワークコンフィギュレーションを実行することをお勧めします。Advanced Multi-User Networking をご参照ください。

新しいセッションに自動接続されます。[Multi-User Browser] ウインドウのレイアウトは、ジョインしたセッションの詳細を表示するために変化します。

さらに、接続状態であることを示すために、メインの Unreal Editor のツールバーのボタンが変化します。

5 - セッションに参加する

サーバーが動作し、1 台のコンピュータで Unreal Editor からサーバーにセッションを作成したので、他のコンピュータで動作している Unreal Editor のインスタンスから同じセッションに接続できます。

セッションに参加する、他のコンピュータで以下を実行します。

[Multi-User Browser (マルチユーザーブラウザ)] ウィンドウを開きます。他のコンピューターで作成したセッションをこのリストで表示されます。
プロジェクトの詳細およびそのセッションに接続中の人を確認するためにセッションを選択します。

セッションにマウスオーバーすると詳細を確認することができます。
ツールバーの [Join the selected session (選択中のセッションにジョインする)] アイコンをクリックします。(またはセッション名をダブルクリックします。)

接続したら、[Multi-User Browser] ウインドウのレイアウトは、ジョインしたセッションの詳細を表示するために変化します。Clients リストの接続された すべての ユーザーとシェアードセッションのすべての参加者による変更履歴を確認することができます。

ユーザー自身が参加する前に、このセッションで他のコンピュータから作業していて、プロジェクトのアセットやレベルに変更を加えている場合、Unreal Editor のインスタンスはサーバーからこれらのトランザクションを自動的に取得し、共有セッションワークスペースのローカルビューにそれらの変更を適用します。他のすべての参加メンバーと同じコンテンツを作業するようになりますが、Unreal Editor UI で必要なコンテンツを自由に作業できます。レベルビューポートでカメラの視点を動き回らせる、コンテンツブラウザで新しいフォルダを参照する、ツールを切り替える、新しいウィンドウやパネルを開く、など他のユーザーに影響を与えることなく実行できます。

単一のセッションに複数のコンピュータが接続したので、1 台のコンピュータで変更して、同じセッションの他のコンピュータにどのように変更が伝わるのかを確認できます。

6 - 共同作業する

同じライブセッションに複数のユーザーが接続されているので、仮想ワールドを共同で構築できます。Unreal Engine プロジェクトで通常通り作業しますが、他のユーザーの変更が適用されたらすぐに結果が反映されます。

ライブで作業しているときの想定される内容については、マルチユーザー編集の概要を参照してください。

7 - セッションの変更を保持する

この時点で、チームメンバーを含めて、プロジェクトのいくつかのアセットやレベルに変更を加えています。しかし、これらのトランザクションは使用するコンピュータのプロジェクトコンテンツを構成する実際のファイルにまだ反映されていません。このライブセッションでチームが実行した作業を保持する場合は、これらの変更を保持する必要があります。つまり、マルチユーザー編集システムが管理するすべてのトランザクションをローカルプロジェクトファイルに適用しなければなりません。

ツールバーの [Source Control (ソースコントロール)] の各ツールを使用して変更を保持します。ソースコントロールプロバイダを使用しているかどうかは関係ありません。

メインツールバーの [Source Control (ソースコントロール)] ボタンの隣にある矢印をクリックし、[Persist Session Changes (セッションの変更を保持)] を選択します。
[Persist & Submit Files (ファイルの保持とサブミット)] ウィンドウで、ライブセッション中に変更されたすべてのファイルのリストが表示されます。変更されたファイルのチェックボックスで、ローカルコンピュータのプロジェクトファイルに適用する対象を指定します。
セッションを開始する、またはセッションに参加するときにソースコントロールプロバイダがセットアップされている場合、新しい変更リストやリビジョンで保持する変更をそのプロバイダにすぐにサブミットするオプションがあります。

すぐにサブミットしない場合、マルチユーザー編集システムはソースコントロールプロバイダーから自動的に修正済みのファイルをチェックアウトして、変更内容をご使用のコンピューターのローカルファイルに保存します。その後、引き続き修正 (セッション中、またはセッションから出てオフライン状態で) が可能です。そして、標準のソースコントロールワークフローを使用してすべての変更を後でまとめてサブミットすることができます。

セッションでの変更内容をソースコントロールにすぐにサブミットするには、以下の手順を行います。
1. ウィンドウの一番下にある [Submit to Source Control (ソースコントロールにサブミット)] チェックボックスをオンにします。
2. 通常のソースコントロールワークフローと同様に、サブミットする変更の説明を入力する必要があります。ウィンドウの一番上にある [Changelist Description (変更リストの説明)] を展開し、このボックスに説明を入力します。
3. サブミットするファイルにさらに変更を加える必要があることがわかっている場合、通常のソースコントロールワークフローと同様に [Keep Files Checked Out (ファイルのチェックアウトを維持)] チェックボックスをオンにできます。
ファイルのリストをサブミットする準備ができたら、ソースコントロールオプションを設定して、[Submit (サブミット)] をクリックします。

セッションに接続したままで、そのまま作業を続けられます。

8 - クリーンアップ

ライブセッションでレベルやアセットにチームメンバーも含めて加えた変更をディスクのプロジェクトに適用し、オプションでこれらの変更をソースコントロールシステムにコミットしたので、セッションが必要なくなっている可能性があります。離れたセッションに再び参加し、選択できますが、長時間古いセッションで作業を続けるのではなく、更新された変更リストから新しい編集セッションを定期的に開始することをお勧めします。

セッションが必要なくなったら、[Multi-User Browser] を使用して削除できます。

削除できるのは、セッションを作成したユーザーだけです。他のユーザーには、対象のセッションに参加していた場合でも、[Multi-User Browser] のオプションが表示されません。

まだ実行していない場合は、セッションから切断します。接続されている間にセッションは削除できません。

ツールバーに [Multi-User Editing] ボタンを表示している場合、接続中は [Leave] と表示されます。このボタンをクリックすれば、セッションを去ることができます。
切断後、[Multi-User Browser] でセッションを選択し、ツールバーの [Delete] アイコンをクリックして削除します。
削除を確定します。

削除したセッションに接続している他のユーザーがいる場合は、自動的に切断されます。
共有セッションにしばらく再接続する必要がないことがわかっている場合は、コンソールウィンドウで、Ctrl+C を押して、サーバーを停止できます。

コンソールウィンドウをそのまま閉じることは避けてください。サーバーで異常シャットダウンと認識します。コンソールウィンドウを閉じたときアクティブであるセッションは、次にサーバーを開始したときに自動的に復元されます。

ここでチュートリアルの最初に戻りますが、共有セッションですべてのユーザーが行った変更が反映されています。

9 - 応用編

以上の手順を問題なく完了しました。Unreal Editor での共同作業のワークフローの感触がつかめたと思います。複数のコンピューターでプロジェクトの設定方法、これらのコンピューターを共同編集セッションへ接続する方法、仮想ワールドをビルドするためにチームメンバーと協力する方法を学習しました。マルチユーザー編集システムを使用すれば、迅速な連携、イタレーション時間なし、創造的な協力など、このワークフローを独自のプロジェクトの自分のチーム内で活かすことができます。

チームでマルチユーザー編集システムを定期的に使用する場合、[Project Settings (プロジェクト設定)] にデフォルトサーバー名とセッション名を設定すると便利です。設定すると、ツールバーボタンが更新されて、[Browse] が [Join] になります。[Toolbar] アイコンを 1 回クリックするとデフォルトセッションに参加できます。プロジェクトを開いたときに、デフォルトセッションに自動的に接続するように選択することもできます。
複数のユーザーが同じアニメーションの同期再生を確認する必要がある場合、マルチユーザー編集システムを設定して、異なるユーザー間でシーケンサ UI の操作を同期することができます。一部のコンソールコマンドを設定することで、各ユーザーがこれにオプトインする必要があります。

変更の必要がある設定ついては、マルチユーザー編集リファレンスを参照してください。