共有空間アンカーサンプルプロジェクトは共有アンカーシステムの機能を示すものです。このサンプルプロジェクトでは、空間アンカーを処理し維持するためのサンプルコードも提供しており、開発者がプロジェクトで再利用することができます。サンプルはUnreal Engineの保存および読み込みシステムも利用して、アプリストレージに永続的アンカーのUUIDを保存します。

サンプルプロジェクトは、GitHubのサンプル⁠の一部として入手可能です。このサンプルプロジェクトでは、イベントディスパッチャーを使って、サンプル内の機能をスケーラブルな方法で呼び出すメニューインターフェイスが実装されています。

設計

BP_MenuItem: メニューアイテムは、メニューのインターフェイスアクターです。現在のインタラクションに対する視覚的なフィードバックと、イベントディスパッチャーを呼び出してプロジェクト内の他の場所でロジックを実行するためのロジックが含まれています。

BP_Menu_Main: このメニューは、アンカーの作成、選択、読み込みなど、個々のアンカーとは関係のないアンカーの一般的な操作を処理します。

BP_Menu_Anchor: このメニューは、選択したアンカーのインタラクションに固有のすべての操作を処理します。これには、選択したアンカーの保存、保存の取り消し、非表示、消去などの操作があります。

ユーザーとのやり取り

右タッチコントローラーのサムスティックを上下に動かして、メニューアイテムを選択します。

空間アンカーを作成するには、[Create Anchor (アンカーの作成)]を選択し、トリガーを引きます。

空間アンカーをストレージに保存する手順は、次のとおりです。

[Select Anchor (アンカーを選択)]に移動します。

保存したい空間アンカーをポイントします。

[Select Anchor (アンカーを選択)]を選択して、トリガーを引きます。

[Save Anchor (アンカーを保存)]を選択し、Aを押します。アンカーがヘッドセットストレージとUnreal保存ゲームに保存されます。

以降のセッションで保存された空間アンカーをアプリに読み込むには、[Load Anchors (アンカーを読み込む)]を選択します。

ロビー

最初にアプリを開くと、パススルーが有効になっている待合室に移動します。右コントローラーにメニューがアタッチされています。次の2つのオプションがあります。

[Create Session (セッションを作成)]: このオプションを選択すると、自動的に接続される新しいローカルネットワークゲームセッションが作成されます。

[Find Session (セッションを探す)]: [Find Session (セッションを探す)]を選択すると、別のローカルプレイヤーが作成した利用可能なローカルインターネットセッションが検索されます。セッションが見つかると自動で接続します。見つからない場合はテキストが赤色になり、ロビーに待機することになります。

シェアしたシーン

ネットワークセッションを作成する、またはネットワークセッションに参加すると、パススルー環境に入ります。右コントローラーにメニューが添付されており、以下のオプションがあります。

[Create Anchor (アンカーを作成)]: このオプションを選択すると、新しいアンカーが作成されます。位置は、コントローラーの上部に表示されるプレビューアンカーによって定義されます。

[Select Anchor (アンカーを選択)]: 環境内のアンカーにカーソルを合わせ、このオプションを選択すると、アンカーに固有の新しいメニューが開きます。

[Load Anchors (アンカーを読み込む)]: このオプションは、[Save Anchors (アンカーを保存)]ボタンで以前に保存したアンカーを読み込みます。

[Spawn Cube (キューブをスポーン)]: このオプションを使用すると、ネットワークキューブが環境内にスポーンされ、コントローラーの上部から生成されます。

[Explode Cube (キューブをエクスプロード)]: 環境内のキューブにカーソルを合わせているときにこのメニューオプションを使用すると、キューブが空中にエクスプロードされます。

スポーンしてアンカーを選択すると、右コントローラーに追加されたメニューが表示されます。これがアンカーメニューです。デフォルトのオプションは以下のとおりです。

[Save Anchor Locally (アンカーをローカルに保存)]: アンカーをローカルデバイスに保存します。

[Save Anchor to Cloud (アンカーをクラウドに保存)]: アンカーをクラウドストレージに保存します。クラウドに保存したアンカーは、セッションの他のユーザーと共有できます。

[Orient to Anchor (アンカーに向ける)]: このボタンは、指定されたアンカーを世界の原点とします。このボタンを複数のアンカーで使おうとすると、最初に選択したアンカーが使用されます。

[Erase Anchor (アンカーを消去)]: シーンからアンカーを削除し、ローカルに保存されているアンカーがあれば、ローカルストレージからも削除します。

ローカルストレージ

ローカルにアンカーを保存すると、次のオプションが表示されます。

[Save Anchor to Cloud (アンカーをクラウドに保存)]: アンカーをクラウドストレージに保存します。クラウドに保存したアンカーは、セッションのほかのユーザーと共有できます。

[Unsave Anchor (アンカーの保存を取り消す)]: アンカーをローカルストレージから削除しますが、シーンからは削除しません。

[Hide anchor (アンカーを非表示にする)]: シーンでアンカーの視覚表現を非表示にしますが、ローカルストレージにはアンカーが保存されたままになります。

[Orient to Anchor (アンカーに向ける)]: シーン全体を選択したアンカーに向けます。

[Erase Anchor (アンカーを消去)]: アンカーをゲームの世界から削除し、ローカルストレージからも削除します。

クラウドストレージ

アンカーをクラウドストレージに保存すると、次のオプションが表示されます。

[Save Anchor Locally (アンカーをローカルに保存)]: アンカーをローカルデバイスに保存します。

[Hide Anchor (アンカーを非表示にする)]: アンカー表現を非表示にします。アンカーはまだ存在しますが、アプリを再起動しても取得できません。

[Share Anchors (アンカーを共有)]: アンカーをセッションに接続しているすべてのユーザーと共有します。他の接続されたユーザーは自動的にアンカーを受信して読み込みます。[Orient To Anchor (アンカーに向ける)]: 世界全体を指定されたアンカーに向けます。

[Erase Anchor (アンカーを消去)]: アンカー表現をゲームの世界から消去しますが、クラウドストレージからは削除しません。