Unreal 中的空間對應

空間對應可讓您將物件放在真實世界的實體表面上。 對應了 HoloLens 周圍的環境後，對使用者而言，全像投影看起來會更真實。 空間對應也會利用深度提示將物件錨定在使用者所處的環境中，這樣更能說服使用者這些全像投影真的在其空間中。 浮動於空間中或隨著使用者移動的全像投影會缺乏真實感，因此您應盡可能放置物品，以營造舒適感。

若要深入了解空間對應品質、放置、遮蔽、轉譯等等，請參閱空間對應文件。

應該下載 Microsoft OpenXR 外掛程式，以使用 Unreal Marketplace 或 GitHub上可用的空間對應。

啟用空間對應

若要在 HoloLens 上啟用空間對應：

• 開啟 [編輯 > 專案設定 ]，然後向下捲動至 [ 平臺 ] 區段。
  • 選取 HoloLens 並勾選 [空間感知]。

若要在 HoloLens 遊戲中加入空間對應，並偵錯 MRMesh：

1. 開啟 ARSessionConfig ，然後展開 [ ARSettings > World Mapping ] 區段。

2. 勾選 [從追蹤的幾何圖形產生網格資料]，這會指示 HoloLens 外掛程式啟動，以非同步方式取得空間對應資料，並透過 MRMesh將其呈現給 Unreal。

3. 勾選 [以線框呈現網格資料]，以在 MRMesh 中顯示每個三角形的白色線框。

執行階段的空間對應

您可以修改下列參數，以更新空間對應執行階段行為：

• 開啟 [編輯 > 專案設定]，向下捲動至 [ 平臺 ] 區段，然後選取 [HoloLens > 空間對應]：

• 每立方米的三角形數量上限計量會更新空間對應網格中三角形的密度。
• 空間網格體積大小是玩家周圍用來呈現和更新空間對應資料的立方體大小。
  • 如果預期的應用程式執行階段環境預期會很大，此值可能需要很大，才能符合真實世界的空間。 如果應用程式只需要在使用者附近的表面上放置全像投影，則此值可能會比較小。 當使用者在世界中行走時，空間對應體積會隨著他們移動。

使用 MongoDB

首先，您必須啟動空間對應：

在為空間擷取了空間對應後，建議您關閉空間對應。 空間對應可能會在一段時間後完成，也可能會在每個方向的光線投射針對 MRMesh 傳回碰撞時完成。

若要可在執行階段存取 MRMesh：

1. 將 ARTrackableNotify 元件新增至藍圖動作項目。

2. 選取 ARTrackableNotify 元件，然後展開 [詳細資料] 面板中的 [事件] 區段。
   • 對您要監視的事件選取 + 按鈕。

在此情況下，會監視 On Add Tracked Geometry 事件，這會尋找與空間對應資料相符的有效世界網格。 您可以在 UARTrackableNotify 元件 API 中找到完整的事件清單。

您可以在藍圖事件圖形或 C++ 中變更網格的材質。 下方螢幕擷取畫面會顯示藍圖路由：

C++ 中的空間對應

在遊戲的 build.cs 檔案中，將 AugmentedReality 和 MRMesh 新增至 PublicDependencyModuleNames 清單：

PublicDependencyModuleNames.AddRange(
    new string[] {
        "Core",
        "CoreUObject",
        "Engine",
        "InputCore",    
        "EyeTracker",
        "AugmentedReality",
        "MRMesh"
});

若要存取 MRMesh，請訂閱 OnTrackableAdded 委派：

#include "ARBlueprintLibrary.h"
#include "MRMeshComponent.h"

void AARTrackableMonitor::BeginPlay()
{
    Super::BeginPlay();

    // Subscribe to Tracked Geometry delegates
    UARBlueprintLibrary::AddOnTrackableAddedDelegate_Handle(
        FOnTrackableAddedDelegate::CreateUObject(this, &AARTrackableMonitor::OnTrackableAdded)
    );
}

void AARTrackableMonitor::OnTrackableAdded(UARTrackedGeometry* Added)
{
    // When tracked geometry is received, check that it's from spatial mapping
    if(Added->GetObjectClassification() == EARObjectClassification::World)
    {
        UMRMeshComponent* MRMesh = Added->GetUnderlyingMesh();
    }
}

注意

已更新和已移除的事件有類似的委派，分別是 AddOnTrackableUpdatedDelegate_Handle 和 AddOnTrackableRemovedDelegate_Handle。

您可以在 UARTrackedGeometry API 中找到完整的事件清單。

另請參閱

• 空間對應