マルチ ユーザー編集リファレンス

マルチ ユーザー編集に関連する、プロジェクト設定、コンソール コマンド、コマンドライン パラメータのリファレンス情報が含まれます。

このページには、マルチ ユーザー編集 の要件、設定、コンソール コマンド、コマンドライン パラメータの情報が含まれます。

プロジェクト設定

Multi-User 編集設定

プロジェクトで マルチ ユーザー編集プラグイン がアクティブ化されているとき、[Project Settings (プロジェクト設定)] ウィンドウの [Plugins (プラグイン)] > [Multi-User Editing (マルチ ユーザー編集)] で次の設定にアクセスできます。

設定

説明

Client Settings (クライアント設定)

Enable Multi-User Toolbar Button

有効にすると、Unreal Engine のメイン ウィンドウのツールバーに、一般的なマルチユーザー編集タスクを実行するためのショートカット ボタンが含まれます。

アイコン ステート

ボタン アクション

Join

切断状態でデフォルト サーバーあるいはセッション名を以下に設定している場合、[Join] をクリックしてデフォルト セッションに参加します。

Browse

デフォルト サーバーあるいはセッション名を以下に設定している場合、[Browse] をクリックすると マルチユーザー ブラウザ が起動して、手動でセッションの検索および参加ができます。

Leave

セッションに接続中の時、[Leave] をクリックして切断します。

Cancel

セッションに接続中の時、[Cancel] をクリックして切断します。

または、ツールバー ボタンの横にある下向きの矢印を使えばいつでも Multi-User Browser にアクセスして、[Project Settings (プロジェクト設定)] ウィンドウを今のページに開いたり、使用中のパソコン上でマルチユーザー サーバーを開始することができます。

Auto Connect

有効にすると、このプロジェクトを開くたびに Unreal Editor 以下に設定されている Default Server URL (デフォルト サーバー)[Default Session Name (デフォルト セッション名)] にすぐに接続を試みます。

Default Server URL

ツールバーの [Go Live (ゴーライブ)] ボタンをクリック、または [Auto Connect (自動接続)][Session Browser (セッション ブラウザ)]

Default Session Name

ツールバーの [Go Live (ゴーライブ)] ボタンをクリック、または [Auto Connect (自動接続)] 設定を有効にしたとき、マルチ ユーザー編集システムが接続を試みるセッション名を設定します。

デフォルト サーバーにこの名前のセッションがない場合は、サーバーが新しいセッションを開始します。

Default Session to Restore

ツールバーの [Join (ジョイン)] ボタンをクリック、または [Auto Connect (自動接続)] 設定を有効にしたとき、保存されたセッションを復元する場合に、そのセッション名を入力します。

Default Save Session As

ツールバーの [Join (ジョイン)] ボタンをクリック、または [Auto Connect (自動接続)] 設定を有効にしたとき、マルチ ユーザー編集システムで開いているセッションを保存する場合に、対象セッションを保存する名前を入力します。

Display Name

すべてのプレゼンス情報で、ユーザー自身を他のユーザーが識別する名前を設定します。

Avatar Color

他のユーザーが確認できるすべてのプレゼンス情報で、マルチ ユーザー編集システムがユーザー自身に関連付ける色を設定します。

Desktop Avatar Actor Class

Unreal Editor を操作するために標準キーボードとマウスを使用しているとき、マルチ ユーザー編集システムが他のユーザーのレベル ビューポートでユーザー自身を表すために使用するクラスを設定します。
デフォルト アバターを変更する場合は、独自のブループリント クラスを組み込みの DesktopPresence クラスから派生させ、必要に応じてクラスをカスタマイズできます。

VRAvatar Actor Class

VR ヘッドセットとコントローラーを使用してレベルで作業するために VR 編集システムを使用しているとき、マルチ ユーザー編集システムが他のユーザーのレベル ビューポートでユーザー自身を表すために使用するクラスを設定します。
デフォルト アバターを変更する場合は、独自のブループリント クラスを組み込みの VRPresence クラスから派生させ、必要に応じてクラスをカスタマイズできます。

Client Settings — Advanced (クライアント設定 - 詳細設定)

Server Port

Server Port 値が優先されます。「高度なマルチユーザー ネットワーク

Discovery Timeout

前に検出されたサーバーが指定時間内にメッセージに応答しない場合、無効とみなされ、Multi-User Browser (マルチ ユーザー ブラウザ) のリストから除外されます。

Session Tick Frequency

Unreal Editor のこのインスタンスがセッション更新する頻度を指定します。

Latency Compensation

シーケンサ再生など時間の同期が重要な操作に関する到着トランザクションを処理するときに、Unreal Editor のインスタンスが適用する補正量を指定します。

Endpoint Settings (エンドポイント設定)

Enable Logging

Unreal Editor のインスタンスが現在のセッションについて詳細情報をロギングするかどうかを指定します。これらのログはプロジェクトの「Saved/Logs/Concert」サブフォルダで確認できます。

このオプションを有効にすると、短時間でディスク スペースが大量に消費される可能性があります。

以前有効にした後でログインを無効にするには、ディスク スペースを回復するためにこれらのログ ファイルを自分で取り除かなければなりません。

Purge Processed Message Delay

処理が完了したセッション状態に関するメッセージをメモリから削除するまで、Unreal Editor のインスタンスが待機する時間を指定します。

Remote Endpoint Timeout

Unreal Editor のリモート インスタンスが指定時間内にメッセージに応答しない場合、無効とみなされ、現在のセッションから除外されます。

Multi-User Transactions 設定

[Plugins (プラグイン)] > [Multi-User Transactions (マルチ ユーザー トランザクション)] で次の設定にもアクセスできます。

マルチ ユーザー編集システムをデフォルト設定で十分使いこなし、システムのしくみを理解するまでこれらの設定を調整しないでください。これらの設定を変更すると、マルチユーザー編集システムの安定性に影響が出ることがあります。

設定

説明

Transaction Settings (トランザクション設定)

Snapshot Transactions Per Second

変更が他のクライアントとすぐに同期されるツールやコントロールの操作、例えばレベル ビューポートでアクタをドラッグ、またはアクタの [Details (詳細)] パネルでスライダーをドラッグする間に、マルチ ユーザー編集システムが 1 秒あたりに送信するトランザクション数です。

Include Object Class Filters

このリストが空の場合、マルチ ユーザー編集システムは自動的に変更のトランザクションをすべてのクラス タイプに送信します。特定のクラスのみに変更を同期する場合は、このリストに対象クラスを指定できます。デフォルトでこのリストに表示される値は、テスト済みで、公開するのに十分安定であると判断されているものです。

Exclude Transaction Class Filters

特定クラスの変更をマルチ ユーザー編集システムが同期することを制限する場合、このリストに対象クラスを指定できます。これらの除外クラスのいずれかを含むオブジェクトへの変更に関するトランザクションは同期されません。
このリストは前の Include Object Class Filters (オブジェクト クラスを含めるフィルタ) リストに優先されます。

デフォルトでは、このリストにはランドスケープ クラスが含まれます。ランドスケープに対する変更は、対象ランドスケープを含むレベルを保存するまで同期されません。

Allowed Transient Properties

通常フィルタで除外される場合でも、常に同期される一時クラス プロパティのリストが含まれます。デフォルトのエントリはエディタでアクタの可視性を同期します。同じレベルで作業している別のユーザーが、アクタの異なるセットの表示、非表示を切り替えられるようにする場合、リストからこれらのデフォルト エントリを除外できます。

これらの値の変更が必要な場合、UI ではなく「Saved/Config/<platform>/Engine.ini」ファイルの [/Script/ConcertSyncCore.ConcertSyncConfig] セクションで直接変更します。

Transaction Settings — Advanced (トランザクション設定 - 詳細設定)

Interactive Editor Hot Reload

すでにロードされたアセットを同じアセットの異なるバージョンで置き換える必要があるときに、Unreal Editor が状況を処理する方法を指定します。これが起きるのは、セッションに接続した別のユーザーがアセットを変更し保存したときです。あるいは変更を保持しないでセッションから離れたとき、エディタがセッション中に変更されたコンテンツを、セッションに参加する前に元からあったコンテンツで置き換える必要があります。

この設定を無効のままにすると、新しくロードされたコンテンツが、すでにロードしていたコンテンツで置き換えられます。変更されたアセットをリロードするかどうかの確認メッセージを表示するにはこの設定を有効にします。

Show Presence in PIE

Play In Editor (PIE) セッションを使用している場合、他のユーザーのプレゼンス情報が表示されるかどうかを指定します。

Package Settings (パッケージ設定)

Exclude Package Class Filters

保存されたパッケージでマルチユーザー サーバーへ継承しないものを決定します。パッケージ パスと特定のアセット クラスによってフィルタリングすることができます。たとえば、/Game/Maps/ to Content Paths を追加すると /Game/Maps/ に保存されているすべてのものに対してマルチユーザー サーバーへの継承を防ぎます。

UnrealMultiUserServer コマンドライン パラメータ

入門ページ には、Unreal Editor の UI 内部から、マルチ ユーザー編集システムのサーバー コンポーネントを起動する方法が示されています。しかし、Unreal Engine がインストールされているコンピュータでコマンド ラインからこのサーバーを起動することもできます。

コマンドラインからサーバーを実行する場合、そのコンピュータにプロジェクトは必要ありません。サーバーはトランザクションと変更アセットのみを記録します。プロジェクト コンテンツ全体が利用できるかどうかに関係ありません。セッションに参加しているコンピュータだけに、プロジェクト コンテンツのコピーが必要です。

マルチ ユーザー編集サーバーは、t Engine/Binaries/<platform>/UnrealMultiUserServer.exe の Unreal Engine インストール フォルダです。起動するとき、コマンドラインの次のオプション パラメータで動作をコントロールできます。

パラメータ

説明

-ConcertSession=

指定した場合、サーバーは開始したとき、この名前で新しいセッションを作成します。次に例を示します。
-ConcertSession=DemoSession

-ConcertProject=

-ConcertSession を指定した場合、サーバーは ConcertProject の値をセッションに関連付けられた Unreal Engine プロジェクトの名前として使用します。同じ名前のプロジェクトが動作している Unreal Editor インスタンスからの接続だけが許可されます。次に例を示します。
-ConcertProject=MyUprojectName

-ConcertVersion=

-ConcertSession を指定した場合、サーバーはセッションに関連付けられた Unreal Engine のバージョンとして ConcertVersion の値を使用します。同じバージョンで構築された Unreal Editor インスタンスからの接続だけが許可されます。次に例を示します。
-ConcertVersion=4.22.0-123456

このバージョン番号を取得するには、Unreal Editor を開き、メイン メニューから [Help (ヘルプ)] > [About Unreal Editor... (Unreal Editor について)] を選択します。

-ConcertRevision=

-ConcertSession を指定した場合、サーバーはセッションに関付けられた基本ソース コントロール変更リストとして ConcertRevsion の値を使用します。ソース コントロールがアクティブであり、ローカルで変更がない、コンテンツの同じリビジョンがチェックアウトされている Unreal Editor インスタンスからの接続だけが許可されます。次に例を示します。
-ConcertRevision=4725058

-ConcertIgnore

マルチ ユーザー編集サーバーが接続している Unreal Editor インスタンスが各セッションが関連するコンテンツ ソース コントロール変更リスト、プロジェクト名、エンジン バージョンと一致するのかを検証しない場合に、この値をコマンドラインに追加します。

プロジェクト コンテンツに多少の不整合があってもクライアントの接続を許可することが便利な場合もありますが、コンテンツが異なるクライアントで同期しないことにより、想定しない動作が起きることを避けるため、通常のワークフローではこの設定を使用しないことをお勧めします。

-ConcertClean

起動したときに一時ストレージ ディレクトリから既存のすべてのセッション ファイルをサーバーが削除する場合、この値をコマンド ラインに追加します。

これにより保存されたすべてのセッションが削除されます。

-ConcertSaveSessionAs=

-ConcertSession を指定した場合、セッションが削除される前にシャットダウンされるときに、サーバーがセッション データを保存するために使用する名前を定義するために、ConcertSaveSessionAs 値を使用します。このように名前を指定することは、Unreal Editor UI で新しいセッションを作成するとき、[Session Data Management (セッション データ管理)]> [Save Session As (名前を付けてセッションを保存)] で設定することと同じです。
セッションが保存され、サーバーがシャットダウンされると、対象セッションの状態を復元するため ConcertSessionToRestore パラメータを指定してサーバーを再び起動できます。

-ConcertSessionToRestore=

-ConcertSession を指定した場合、このパラメータを使用して、新しいセッションを作成しないで、サーバーが前に指定名で保存したセッションを復元できます。

Unreal Editor コマンドライン パラメータ

コマンド ラインから Unreal Editor を起動する場合、次のパラメータを使用して、マルチ ユーザー編集システムの動作をコントロールできます。これらのパラメータは前の Project Settings (プロジェクト設定) にリストされている設定の一部にデフォルト値を設定します。

パラメータ

説明

-ConcertAutoConnect

プロジェクトの Auto Connect (自動接続) 設定を有効にします。スタートアップ直後に、Unreal Editor は設定されているデフォルト サーバーとセッションに接続を試みます。[Project Settings (プロジェクト設定)] でこのデフォルト セッション コンフィギュレーションを事前設定、または以下のパラメータを使用してコマンドラインで指定できます。

-ConcertServer=

プロジェクトの Default Server URL (デフォルト サーバー URL) 設定の値を設定します。

-ConcertSession=

プロジェクトの Default Session Name (デフォルト セッション名) 設定の値を設定します。

-ConcertSaveSessionAs=

プロジェクトの Default Save Session As (名前を付けて保存するセッションのデフォルト) 設定の値を設定します。

-ConcertSessionToRestore=

プロジェクトの Default Session to Restore (デフォルトの復元するセッション) 設定の値を設定します。

-ConcertDisplayName=

プロジェクトの Display Name (表示名) 設定の値を設定します。

コンソール コマンド

このセクションでは、マルチ ユーザー編集システムに影響を与える Unreal Engine コンソール コマンドをリストします。

コマンド

説明

Concert.DefaultConnect

プロジェクト設定で Default Server URL (デフォルト サーバー URL)Default Session Name (デフォルト セッション名) をセットアップし、マルチ ユーザー編集セッションに接続していない場合、このコンソール コマンドはデフォルト サーバーとセッションへの接続をすぐに試みます。

Concert.Disconnect

接続されている場合はそのセッションから切断します。

Concert.EnableOpenRemoteSequencer

この設定が有効であるユーザーがシーケンサ UI でレベル シーケンスまたはマスター シーケンスを開くとき、マルチ ユーザー編集システムは、同じセッションのこの設定が有効である他のすべてのユーザーのシーケンサ UI を開き、同じシーケンスをロードします。
この設定はデフォルトでは無効です。Concert.EnableOpenRemoteSequencer 1 で有効にする、または Concert.EnableOpenRemoteSequencer 0 で無効にします。

Concert.EnablePresence

この設定を有効にすると、プロジェクト設定で Desktop Avatar Actor Class (デスクトップ アバター アクタ クラス) または VRAvatar Actor Class (VR アバター アクタ クラス) を設定した同じレベルで作業している他のユーザーのその時点の位置と視点を表す、アクタがレベル ビューポートに表示されます。

Concert.EnableSequencePlayer

デフォルトでは、マルチ ユーザー編集システムは、シーケンサ UI で同じシーケンスを開いている Unreal Editor インスタンス間でシーケンサ再生イベントを同期するだけです。
In -game モードで動作している Unreal Editor インスタンスとシーケンサ再生イベントを同期する場合、この設定を有効にします。
この設定はデフォルトでは無効です。
Concert.EnableOpenRemoteSequencer 1 で有効にする、または Concert.EnableOpenRemoteSequencer 0 で無効にします。再生イベントに対応する -game 引数で開始する各 Unreal Editor インスタンスに対して、有効にする必要があります。

-game オプションを使ってプロジェクトを起動する場合、-messaging オプションを含める必要があることを忘れないでください。

Concert.OpenBrowser

[Multi-User Browser (マルチ ユーザー ブラウザ)] ウィンドウを開きます。メイン メニューから [Window (ウィンドウ)] > [Developer Tools (デベロッパー ツール)] > [Multi-User Browser (マルチユーザー ブラウザ)] の選択、またはツールバーのマルチユーザー編集ボタンの横にある下向き矢印から Session Browser を選択しても開きます。

Concert.OpenSettings

[Project Settings (プロジェクト設定)] ウィンドウを開いて、[Plugins (プラグイン)] - [Multi-User Editing (マルチ ユーザー編集)] ページを表示します。ツールバーの [Multi-User Settings (マルチ ユーザー設定)] ボタンの横にある下向き矢印で [Multi-User Settings] を選択した場合と同じです。
これらの設定の詳細については、前述の プロジェクト設定 を参照してください。

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