Unreal Engine の Collab Viewer に独自のコンテンツを追加する | Unreal Engine 5.0 ドキュメンテーション

「Collab Viewer」テンプレートには、すぐに作業を開始できるようにプリセットコンテンツが付属しています。詳細な手順については、「クイックスタートガイド」を参照してください。ただし、共同レビュー環境に慣れたら、その環境に自分独自のコンテンツを取り込むことをお勧めします。

このページでは、最も一般的ないくつかの関連タスクの実行方法について説明します。

独自の 3D モデルをテンプレートに取り込み、ビルトインのナビゲーションモードに対応できるように設定する。「独自の 3D モデルを使用する」を参照してください。
「Collab Viewer」テンプレートに組み込まれているインタラクションツールを使用して、コンテンツの動作方法を制御する。「トランスフォームおよび XRay の挙動を制御する」を参照してください。
デフォルトのプリセットコンテンツが含まれるレベルとは異なるレベルで開始するように「Collab Viewer」テンプレートを変更する。「開始レベルを変更する」を参照してください。
ランタイム時に独自の Datasmith コンテンツをロードする。「ランタイム時に独自の Datasmith コンテンツをロードする」を参照してください。

独自の 3D モデルを使用する

「Collab Viewer」テンプレートには、すぐに作業を開始できるようにプリセットコンテンツが付属しています。ただし、同じ共同表示環境で自分独自のモデルを操作できるようにするには、独自のモデルに切り替える必要があります。

このプロセスで念頭に置く必要のある最重要事項は、プレイヤーが歩いたり、テレポートしたりできるのは、コリジョンメッシュやナビメッシュを含むサーフェスに対してのみという点です。プレイヤーが探索できるようにしたい各フロアまたはサーフェスに、コリジョンボリュームとこのボリュームに関連付けられたナビメッシュがあることを確認する必要があります。

ステップ

Collab Viewer テンプレートのデフォルトのレベル内で独自のコンテンツを機能させるには、次のような考え方の手順を実行する必要があります。

レベルから 3D モデルやライトなどの既存のコンテンツを削除して、独自のコンテンツを追加します。
建物、ギアアセンブリ、木などのサンプルアセットは、 SampleLevel という名前のサブレベルにまとめられています。

レベルを一から開始するには、この既存のサブレベルを削除して、自分のコンテンツをメインのパーシスタントレベル (または作成する新しいサブレベル) に配置するだけです。天球、ライトなど、サンプルシーンのシーン要素の一部を維持したい場合は、それらのアイテムをメインのパーシスタントレベルに移動できます。また、 [World Outliner (アウトライナ)] で「Building」、「Gears」、および「Trees」フォルダなど、不要になったアイテムを選択して削除することもできます。
コンテンツを配置して、パッケージ化されたアプリケーションで表示させたいとおりに、そのコンテンツのビジュアルを設定します。
プレイヤーが歩けたり、テレポートしたりできるようにしたい各サーフェスに、歩行やテレポートができるように設定されたコリジョンメッシュがあることを確認します。
コンテンツのインポート方法によっては、ジオメトリのモデリングに使用する 3D デザインアプリケーションでこれを実行できる場合があります。その他の場合、これを実行するためには、スタティックメッシュエディタでスタティックメッシュを開き、 [Collision (コリジョン)] メニューのツールを使用します。
拡大表示するには、画像をクリック。

コリジョンの設定を自動化する場合は、「スタティックメッシュによるコリジョンのセットアップ」または「ブループリントおよび Python でのスタティックメッシュによるコリジョンのセットアップ」も参照してください。

ブロッキングボリューム を使用して、非表示のボックス型のコリジョンボリュームをレベルに追加する方法もあります。これは、スタティックメッシュを変更する必要なく、レベルでコリジョンを機能させることができる簡単な方法です。ただし、このようなボリュームはスタティックメッシュにアタッチされていないため、レベルでジオメトリを移動させる場合は、手動で移動する必要があります。
レベルに 1 つ以上の Player Start アクタがあることを確認します。Player Start アクタを追加する必要がある場合は、[Place Actors] パネルの [Basic (基本)] タブから追加の Player Start アクタを [Viewport (ビューポート)] にドラッグできます。
拡大表示するには、画像をクリック。

新しいプレイヤーがセッションに参加すると、そのプレイヤーはランダムに選択された Player Start アクタの位置から開始します。新しいプレイヤーが問題なく開始するためには常に、レベルに 1 つ以上の Player Start アクタが必要です。プレイヤーが歩行モードに切り替えても、サーフェスから落ちないように、歩行可能なサーフェスのすぐ上にアクタを配置するとよいでしょう。

このようなアクタのいくつかを同じ場所の周りに追加することをお勧めします。これで、新しいプレイヤーがセッションに参加したときに、他のプレイヤーの正確な場所と重なってしまう可能性が低下します。
プレイヤーのテレポート先にしたい各サーフェスに、ナビメッシュがあることを確認します。これには、Nav Mesh Bounds Volume (ナビメッシュバウンズ) にナビメッシュを追加します。デフォルトのパーシスタントレベルには、サイズを変更して 3D モデルに対応できるボリュームが既にあります。または、ユーザーが独自のボリュームを作成することもできます。このようなボリュームはレベルに必要なだけいくつでも配置できます。
ナビメッシュを作成するには、次の手順を実行します。
1. レベルに Nav Mesh Bounds Volume (ナビメッシュバウンズ) が配置されていない場合は、[Place Actors] パネルの [Volumes (ボリューム)] タブからこのボリュームを [Viewport (ビューポート)] にドラッグして追加します。
  拡大表示するには、画像をクリック。
2. [Viewport] または [World Outliner (アウトライナ)] で [Nav Mesh Bounds Volume] を選択して、ビューポートでそのトランスフォームギズモをカバーしたい領域のほぼ中心に移動します。
3. [Details (詳細)] パネルで、 [Brush Settings (ブラシ設定)] を使用して、ボリュームのサイズと形状を変更します。
  拡大表示するには、画像をクリック。
4. ツールバーの [Build (ビルド)] アイコンをクリックして、レベルの事前計算データを再ビルドするか、 [Build (ビルド)] > [Navigation (ナビゲーション)] > [Build Paths (パスをビルド)] を選択してナビゲーションデータのみを再ビルドします。
  拡大表示するには、画像をクリック。
5. 「P」キーを押して、生成されたナビメッシュを表示し、ナビメッシュが期待する領域をカバーしていることを確認します。ナビメッシュは、ボリュームと交差するコリジョンメッシュのやや上に重なっている緑色のサーフェスとしてレンダリングされます。
  拡大表示するには、画像をクリック。
必要に応じて、ライティングをビルドします。
「クイックスタートガイド」ページの手順に従って、プロジェクトを再パッケージ化して再配布します。

最終結果

上記の手順をすべて実行すると、複数のユーザーが単一のデザインレビューセッションに接続できるようになり、レベルに追加したカスタムコンテンツを全員で確認できます。

トランスフォームおよび XRay の挙動を制御する

コンテンツの設定方法により、トランスフォームと Xray (シースルー) のインタラクションのランタイム時の動作に影響を与えることができます。

各アクタの [Mobility (可動性)] 設定では、ランタイム時にトランスフォームインタラクションを使用して該当オブジェクトを移動できるかどうかを決定します。ランタイム時にオブジェクトを移動できるようにする場合は、 [Mobility] を [Movable (可動)] に設定します。オブジェクトをハイライトして選択できるようにしたいものの、空間でオブジェクトを移動できないようにする場合は、 [Mobility] を [Static (スタティック)] に設定します。
[World Outliner (アウトライナ)] にある親アクタと子アクタの階層は、トランスフォームインタラクションと Xray (シースルー) インタラクションの両方に影響を与えます。
- トランスフォームインタラクションを使用してランタイム時にオブジェクトを移動すると、オブジェクトのすべての子は親とともに自動的に移動し、親からのその時点のオフセットが維持されます。
  
  たとえば、この場合、トランスミッションのすべてのパーツが、大きい平らな基礎アクタである Building_Parent の子になります。
  
  画像をクリックして拡大表示します。
  
  そのため、ランタイム時に基礎アクタを動かすと、子アクタも移動します。ただし、それぞれの子アクタを個別に移動することもできます。この次に親を移動すると、子は連動して新しいオフセットが維持されます。
  
  子アクタを元の位置にリセットすると、親アクタからの元のオフセットにリセットされますが、ワールド空間での元の位置 (回転状態) ではありません。親アクタを元の位置にリセットすると、すべての子が移動し、親からのその時点のオフセットが維持されます。
- Xray Isolate インタラクションモードを使用して、シーンの 1 つのオブジェクトを選択すると、選択したオブジェクトと同じ階層にある他のすべてのオブジェクトが自動的に非表示になります。
  
  たとえば、デフォルトのシーンコンテンツの場合、メインの建物を構成するすべてのオブジェクトは、階層の単一の最上位の親の下にあります。そのため、Xray Isolate を使用して建物の一部を選択すると、建物の他のすべての部分、つまり、同じ最上位の Building_Parent アイテムを親とするすべてのアクタが非表示になります。
拡大表示するには、画像をクリック。

木と外部テレインは、 Building_Parent 階層下でないため、影響を受けません。
Xray またはトランスフォームコマンドのどちらかを使用してアクタを操作できるようにしたい場合、 [Simulate Physics (物理シミュレーション)] 設定がオフである必要があります。これは、 [Physics (物理)] セクションの下にある [Details (詳細)] パネルにあります。

Click image to expand.

開始レベルを変更する

「Collab Viewer」テンプレートのメインメニューは、ユーザーがメインメニューを完了すると、 CollaborativeViewer_P レベルをロードするように設定されています。ただし、自分のコンテンツを保持するために新しいレベルを作成して、メインメニューでこのレベルではなく独自のレベルを開始したい場合があります。この場合は、ユーザーがセッションに参加したときにレベルが開くように、メインメニューでロジックを変更する必要があります。

ステップ

Collab Viewer の開始レベルを設定するには、次の手順を実行します。

コンテンツブラウザ の CollaborativeViewer/UMG/MainMenu フォルダで、Widget_MainMenu アセットを検索します。
拡大表示するには、画像をクリック。
アセットをダブルクリックして開き、 [Graph (グラフ)] をクリックしてウィジェットブループリントビューを開きます。
拡大表示するには、画像をクリック。
[Commit user selections (ユーザー選択の確定)] というラベルのグループを見つけます。このグループ内で、 [Begin hosting a session (セッションのホスティングを開始)] という名前のサブグループを検索します。
拡大表示するには、画像をクリック。
OpenLevel ノードの Level Name 入力を、ユーザーがセッションに接続すると開始するレベルの名前に変更します。
拡大表示するには、画像をクリック。
ウィジェットを コンパイル して保存し、プロジェクトを再パッケージ化します。

最終結果

次回プロジェクトを開始して、メインメニューを完了すると、上記の手順で設定したカスタムレベル内から開始されます。

ランタイム時に独自の Datasmith コンテンツをロードする

この機能は 実験段階 と見なされています。現在、この機能はシングルプレイヤーのみ機能し、マルチプレイヤーでは使用できません。

この機能により、ランタイム時に Datasmith ファイルをロードできるようになりました。現時点では、.udatasmith ファイル形式のみに制限されています。

メインメニューからの Datasmith のランタイム時ロード。

Collab Viewer にインポートするために選択するファイルのポップアップウィンドウ。

[追加 (+)] ボタンをクリックして新しい [Destination (インポート先)] スロットに新しいファイルをインポートします。
既存のインポート済みアクタを削除するには、まず該当するインポート先を選択し、 ゴミ箱 アイコンを押します。
[Source (インポート元)] ボタンを使用すると、インポートするファイル形式を選択するためのエクスプローラウィンドウが開きます。
位置ラインを使用すると、ユーザーはインポート済み階層のルート位置を変更できます。