Microsoft Mixed Reality Toolkit 2.6 版本資訊

重要

已知編譯器問題會影響使用 ARM64 為 Microsoft HoloLens 2 建置的應用程式。 將 Visual Studio 2019 更新至 16.8 版或更新版本,可修正此問題。 如果您無法更新Visual Studio,請匯 com.microsoft.mixedreality.toolkit.tools 入套件以套用因應措施。

2.6.2 的新功能

更正空間網格的父系

修正在移動Mixed Reality Playspace 物件之後,空間網格未正確定位的問題 (,例如:透過遠端傳送) 。

2.6.1 的新功能

修正 OpenXR 未在 HoloLens 2 / UWP 上執行

修正導致 MRTK 的 OpenXR 支援無法在 UWP 上執行的回歸。

修正 Leap Motion ObjectManipulator 未旋轉

修正了 ObjectManipulator 腳本未考慮 Leap Motion 手部旋轉的回歸。

範例場景更新

更新場景瞭解範例場景,以正確反映 Unity 外掛程式的出貨狀態。 此外,也會將範例更新為不再相依于要匯入的空間感知範例場景。 更新至 2.6.1 之前,如果匯入的場景理解和空間感知範例存在於您的專案中,您應該刪除它們以避免可能發生的衝突。 如果您未移除這些範例,並看到與主控台中的範例相關的衝突,請移除這兩個範例 (或 Assets/Samples/Mixed Reality Toolkit Examples 資料夾) ,然後再試一次匯入。

更新對話方塊範例場景,以正確描述目前的對話案例。

2.6.0 的新功能


新增 OpenXR 的支援

已新增 Unity 的 OpenXR 預覽套件和 Microsoft Mixed Reality OpenXR 套件的初始支援。 如需詳細資訊,請參閱 MRTK/XRSDK 使用者入門頁面Unity 論壇文章Microsoft 的檔

重要

Unity 中的 OpenXR 僅支援 Unity 2020.2 和更新版本。

目前,它也僅支援 x64 和 ARM64 組建。

資產交換公用程式

使用新的 資產交換公用程式,在Unity 場景中交換多個資產。

HP 運動控制器現在支援 MRTK

HP Reverb G2 的控制器現在可原生使用 MRTK。

實驗性互動式元素 + 狀態視覺化檢視

Interactive Element 是 MRTK 輸入系統的簡化集中式進入點。 它包含狀態管理方法、事件管理和核心互動狀態的狀態設定邏輯。 如需詳細資訊,請參閱 Interactive Element 檔

InteractiveElementAddCoreState

狀態視覺化檢視是相依于 Interactive 元素的動畫元件。 此元件會建立動畫剪輯、設定主要畫面格,並產生 Animator State Machine。 如需詳細資訊,請參閱 狀態視覺化檢視檔

StateVisualizerColorChangeOnFocus

所有平臺上現在都支援具有遠端傳送手勢的遠端傳送

使用者現在可以使用電匯手勢,在所有平臺上移動其播放空間。 若要在具有預設設定的 MR 裝置上以控制器傳送電話,請使用搖桿。 若要使用已表達的手部進行遠端移植,請利用手部向外貼上索引和拇指,藉由捲動索引手指來完成電匯。 若要使用輸入模擬來傳送電話,請參閱更新的 輸入模擬服務檔

Teleport Gesture

SCENE Understanding 現在可在 MRTK 中作為實驗性空間感知觀察者使用

MRTK 2.6 引進 了 Scene Understanding 的實驗性支援。 使用者可以將HoloLens 2的場景理解功能納入 MRTK 型專案中的空間感知觀察者。 如需詳細資訊,請參閱 Scene Understanding 檔

重要

只有 HoloLens 2 和 Unity 2019.4 和更新版本才支援 Scene Understanding。

此功能需要 Scene Understanding 套件,現在可透過Mixed Reality功能工具取得。 使用Mixed Reality功能工具或透過 UPM 匯入時,請先匯入 Demos - SpatialAwareness 範例,再匯入實驗性 - SceneUnderunderstanding 範例,因為相依性問題。 如需詳細資訊,請參閱此GitHub問題

Scene Understanding

執行時間設定檔切換支援

MRTK 現在允許在 MRTK 實例初始化 (之前切換設定檔,也就是預先 MRTK 初始化設定檔切換) ,以及在設定檔在使用中之後切換 (,也就是使用中設定檔參數) 。 前一個參數可用來根據硬體的功能啟用選取元件,而後者可用來修改體驗,因為使用者輸入應用程式的子元件。 如需詳細資訊和程式碼範例 ,請參閱設定檔切換的檔

方向指示器和遵循實驗性解算器

兩個新的解算器已準備好與主線 MRTK 搭配使用。

Directional Indicator Solver

手部指導已從實驗性中升級

手部指導功能現在已準備好與主線 MRTK 搭配使用。

Hand Coach Example

對話方塊控制項已從實驗性中移除

對話方塊控制項現在已準備好與主線 MRTK 搭配使用。

Dialog Controls

從實驗性發展而來的脈衝著色器

Pulse 著色器腳本已從實驗性發展而來。 如需詳細資訊,請參閱: 脈衝著色器檔

MRTK_SpatialMesh_Pulse

輸入錄製服務改善

InputRecordingServiceInputPlaybackService 現在可以錄製並播放眼球注視輸入。 錄製已優化,以確保錄製期間內一致的畫面播放速率,同時錄製檔案大小和節省時間也減少約 50%。 現在可以以非同步方式執行錄製檔案的儲存和載入。 請注意,此 MRTK 版本的錄製檔案格式已變更,如需新版本 1.1 規格的詳細資訊,請參閱 這裡

閱讀模式

已新增在 HoloLens 2 上讀取模式的支援。 閱讀模式可減少系統的檢視欄位,但可消除 Unity 輸出的縮放比例。 Unity 所轉譯的圖元會對應至HoloLens 2上的投影圖元。 應用程式作者應該使用多個個人進行測試,以確定這是他們在應用程式中想要的取捨。

Windows Mixed Reality reading mode

UWP 上的 3D 應用程式啟動器支援

新增為 UWP 設定 3D 應用程式啟動器 的功能。 此設定會在 [MRTK 建置視窗] 和 [MRTK Project 設定] 底下的 [建置設定中公開。 它會在 Unity 的組建期間自動寫入專案中。

Build settings

重大變更

匯入之 GLTF 物件的某些欄位現在已大寫

由於還原序列化相關問題,匯入 GLTF 物件的某些欄位現在以大寫字母開頭。 受影響的欄位在其新名稱中 () :、、、、 MagFilterTargetTypeModeWrapSMinFilterWrapTInterpolationPathComponentType

輸入動畫二進位檔案具有更新的 1.1 版格式

InputPlaybackService 所使用的 InputRecordingService 輸入動畫二進位檔現在有更新的檔案格式,可讓這兩項服務進行優化。 如需新版本 1.1 規格的詳細資訊,請參閱 這裡

適用于 Unity 支援的MSBuild

自 2.5.2 版起,已移除 Unity MSBuild的支援,以符合Unity 的新套件指引

已知問題

OpenXR

Holographic Remoting 和 OpenXR 目前有已知問題,其中手部接合無法一致使用。 此外,眼球追蹤範例場景目前不相容,不過眼球追蹤 仍可 運作。

某些Mixed Reality工具組標準著色器功能需要 Foundation 套件

透過 Unity 封裝管理員匯入時,MRTK 標準著色器公用程式腳本 (例如:HoverLight.cs) 不會與標準資產套件中的著色器共置。 若要存取這項功能,應用程式需要匯入 Foundation 套件。

CameraCache 可能會在關機時建立新的相機

在某些情況下, (例如在 Unity 編輯器中使用 LeapMotion 提供者) 時,CameraCache 可以在關機時重新建立 MainCamera。 如需詳細資訊,請參閱 此問題

透過 Unity 封裝管理員匯入範例時,FileNotFoundException

視專案路徑的長度而定,透過 Unity 封裝管理員匯入範例可能會在 Unity 主控台中產生 FileNotFoundException 訊息。 原因是「遺漏」檔案的路徑超過 MAX_PATH (256 個字元) 。 若要解決,請縮短專案路徑的長度。

未指定空間化程式。 應用程式不支援空間音效

如果未設定音訊空間化程式,則會出現「未指定空間化程式」警告。 如果未安裝 XR 套件,就會發生這種情況,因為 Unity 會在這些套件中包含空間化程式。

若要解決,請確定:

  • 視窗>封裝管理員已安裝一或多個 XR 套件

  • Mixed Reality工具組>公用程式>設定 Unity Project,並選取音訊空間化工具

    Select Audio Spatializer

NullReferenceException:物件參考未設定為 sceneTransitionService.Initialize (物件的實例)

在某些情況下,開啟 EyeTrackingDemo-00-RootScene 可能會導致 SceneTransitionService 類別之 Initialize 方法中的 NullReferenceException。 此錯誤是因為未設定場景轉換服務的組態設定檔所造成。 若要解決,請使用下列步驟:

  • 流覽至 MixedRealityToolkit Hierarchy 中的物件
  • 在 [偵測器] 視窗中,選取 Extensions
  • 如果未展開,請展開 Scene Transition Service
  • 將 的值 Configuration Profile 設定為 MRTKExamplesHubSceneTransitionServiceProfile

Fix Scene Transition Profile

Oculus Quest

以獨立平臺為目標時,目前有一個已知問題是 搭配使用 XR 外掛程式。 請查看 0s 錯誤追蹤器/論壇/版本資訊以取得更新。

錯誤會以這組 3 個錯誤表示:

Oculus XR Plugin Error

UnityUI 和 TextMeshPro

較新版本的 TextMeshPro (1.5.0+ 或 2.1.1+) 有已知問題,其中下拉式清單和粗體字型大小間距的預設字型大小已改變。

TMP image

這可藉由降級為舊版 TextMeshPro 來解決此問題。 如需詳細資訊,請參閱 問題 #8556