このページには、マルチ ユーザー編集 の要件、設定、コンソール コマンド、コマンドライン パラメータの情報が含まれます。
プロジェクト設定
Multi-User 編集設定
プロジェクトで マルチ ユーザー編集プラグイン がアクティブ化されているとき、[Project Settings (プロジェクト設定)] ウィンドウの [Plugins (プラグイン)] > [Multi-User Editing (マルチ ユーザー編集)] で次の設定にアクセスできます。
設定 | 説明 | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Client Settings (クライアント設定) | |||||||||||
Enable Multi-User Toolbar Button | 有効にすると、Unreal Engine のメイン ウィンドウのツールバーに、一般的なマルチユーザー編集タスクを実行するためのショートカット ボタンが含まれます。
または、ツールバー ボタンの横にある下向きの矢印を使えばいつでも Multi-User Browser にアクセスして、[Project Settings (プロジェクト設定)] ウィンドウを今のページに開いたり、使用中のパソコン上でマルチユーザー サーバーを開始することができます。 |
||||||||||
Auto Connect | 有効にすると、このプロジェクトを開くたびに Unreal Editor 以下に設定されている Default Server URL (デフォルト サーバー) と [Default Session Name (デフォルト セッション名)] にすぐに接続を試みます。 | ||||||||||
Default Server URL | ツールバーの [Go Live (ゴーライブ)] ボタンをクリック、または [Auto Connect (自動接続)] 設定を有効にしたとき、マルチ ユーザー編集システムが接続を試みるサーバー名を設定します。 |
||||||||||
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 を操作するために標準キーボードとマウスを使用しているとき、マルチ ユーザー編集システムが他のユーザーのレベル ビューポートでユーザー自身を表すために使用するクラスを設定します。 |
||||||||||
VRAvatar Actor Class | VR ヘッドセットとコントローラーを使用してレベルで作業するために VR 編集システムを使用しているとき、マルチ ユーザー編集システムが他のユーザーのレベル ビューポートでユーザー自身を表すために使用するクラスを設定します。 |
||||||||||
Client Settings — Advanced (クライアント設定 - 詳細設定) | |||||||||||
Server Port | Unreal Editor からマルチユーザー編集サーバーを起動する時に、この設定はサーバーがマルチキャスト トラフィック用にリッスンするポートを指定します。 |
||||||||||
Discovery Timeout | 前に検出されたサーバーが指定時間内にメッセージに応答しない場合、無効とみなされ、Multi-User Browser (マルチ ユーザー ブラウザ) のリストから除外されます。 | ||||||||||
Session Tick Frequency | Unreal Editor のこのインスタンスがセッション更新する頻度を指定します。 | ||||||||||
Latency Compensation | シーケンサ再生など時間の同期が重要な操作に関する到着トランザクションを処理するときに、Unreal Editor のインスタンスが適用する補正量を指定します。 | ||||||||||
Endpoint Settings (エンドポイント設定) | |||||||||||
Enable Logging | Unreal Editor のインスタンスが現在のセッションについて詳細情報をロギングするかどうかを指定します。これらのログはプロジェクトの「 このオプションを有効にすると、短時間でディスク スペースが大量に消費される可能性があります。 以前有効にした後でログインを無効にするには、ディスク スペースを回復するためにこれらのログ ファイルを自分で取り除かなければなりません。 |
||||||||||
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 | 特定クラスの変更をマルチ ユーザー編集システムが同期することを制限する場合、このリストに対象クラスを指定できます。これらの除外クラスのいずれかを含むオブジェクトへの変更に関するトランザクションは同期されません。 デフォルトでは、このリストにはランドスケープ クラスが含まれます。ランドスケープに対する変更は、対象ランドスケープを含むレベルを保存するまで同期されません。 |
Allowed Transient Properties | 通常フィルタで除外される場合でも、常に同期される一時クラス プロパティのリストが含まれます。デフォルトのエントリはエディタでアクタの可視性を同期します。同じレベルで作業している別のユーザーが、アクタの異なるセットの表示、非表示を切り替えられるようにする場合、リストからこれらのデフォルト エントリを除外できます。 これらの値の変更が必要な場合、UI ではなく「 |
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= |
指定した場合、サーバーは開始したとき、この名前で新しいセッションを作成します。次に例を示します。 |
-ConcertProject= |
-ConcertSession を指定した場合、サーバーは ConcertProject の値をセッションに関連付けられた Unreal Engine プロジェクトの名前として使用します。同じ名前のプロジェクトが動作している Unreal Editor インスタンスからの接続だけが許可されます。次に例を示します。 |
-ConcertVersion= |
-ConcertSession を指定した場合、サーバーはセッションに関連付けられた Unreal Engine のバージョンとして ConcertVersion の値を使用します。同じバージョンで構築された Unreal Editor インスタンスからの接続だけが許可されます。次に例を示します。 このバージョン番号を取得するには、Unreal Editor を開き、メイン メニューから [Help (ヘルプ)] > [About Unreal Editor... (Unreal Editor について)] を選択します。 |
-ConcertRevision= |
-ConcertSession を指定した場合、サーバーはセッションに関付けられた基本ソース コントロール変更リストとして ConcertRevsion の値を使用します。ソース コントロールがアクティブであり、ローカルで変更がない、コンテンツの同じリビジョンがチェックアウトされている Unreal Editor インスタンスからの接続だけが許可されます。次に例を示します。 |
-ConcertIgnore | マルチ ユーザー編集サーバーが接続している Unreal Editor インスタンスが各セッションが関連するコンテンツ ソース コントロール変更リスト、プロジェクト名、エンジン バージョンと一致するのかを検証しない場合に、この値をコマンドラインに追加します。 プロジェクト コンテンツに多少の不整合があってもクライアントの接続を許可することが便利な場合もありますが、コンテンツが異なるクライアントで同期しないことにより、想定しない動作が起きることを避けるため、通常のワークフローではこの設定を使用しないことをお勧めします。 |
-ConcertClean | 起動したときに一時ストレージ ディレクトリから既存のすべてのセッション ファイルをサーバーが削除する場合、この値をコマンド ラインに追加します。 これにより保存されたすべてのセッションが削除されます。 |
-ConcertSaveSessionAs= |
-ConcertSession を指定した場合、セッションが削除される前にシャットダウンされるときに、サーバーがセッション データを保存するために使用する名前を定義するために、ConcertSaveSessionAs 値を使用します。このように名前を指定することは、Unreal Editor UI で新しいセッションを作成するとき、[Session Data Management (セッション データ管理)]> [Save Session As (名前を付けてセッションを保存)] で設定することと同じです。 |
-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.EnablePresence |
この設定を有効にすると、プロジェクト設定で Desktop Avatar Actor Class (デスクトップ アバター アクタ クラス) または VRAvatar Actor Class (VR アバター アクタ クラス) を設定した同じレベルで作業している他のユーザーのその時点の位置と視点を表す、アクタがレベル ビューポートに表示されます。 |
Concert.EnableSequencePlayer |
デフォルトでは、マルチ ユーザー編集システムは、シーケンサ UI で同じシーケンスを開いている Unreal Editor インスタンス間でシーケンサ再生イベントを同期するだけです。
|
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] を選択した場合と同じです。 |