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

輸入錄製服務改善

InputRecordingService 和 InputPlaybackService 現在可以錄製並播放眼球注視輸入。 錄製已優化，以確保錄製期間內一致的畫面播放速率，同時錄製檔案大小和節省時間也減少約 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 物件的某些欄位現在以大寫字母開頭。 受影響的欄位在其新名稱中 () ：、、、、 MagFilterTargetTypeModeWrapSMinFilterWrapT 。 InterpolationPathComponentType

輸入動畫二進位檔案具有更新的 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 。