共用方式為

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 場景中交換多個資產。

MRTK 現在支援 HP 動作控制器

HP Reverb G2 的控制器現在可與 MRTK 原生運作。

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

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

InteractiveElementAddCoreState

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

StateVisualizerColorChangeOnFocus

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

使用者現在可以使用電匯手勢，在所有平臺上移動其播放空間。 若要在具有預設設定的 MR 裝置上使用控制器進行遠端傳送，請使用搖桿。 若要使用已表達的手部進行遠端移植，請以手部向上向右手勢，並讓手指向外黏住，以完成遠端傳送。 若要透過輸入模擬進行遠端傳送，請參閱我們更新的 輸入模擬服務檔。

Teleport 手勢

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

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

重要

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

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

場景瞭解

執行時間設定檔切換支援

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

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

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

方向指標規劃求解

手部指導已從實驗性中培養

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

手部指導範例

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

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

對話方塊控制項

來自實驗性的脈衝著色器

脈衝著色器腳本已從實驗性中升級。 如需詳細資訊，請參閱 ：脈衝著色器檔

MRTK_SpatialMesh_Pulse

輸入錄製服務改善

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

閱讀模式

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

Windows Mixed Reality閱讀模式

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

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

組建設定

重大變更

匯入之 GLTF 物件的特定欄位現在已大寫

由於還原序列化相關問題，匯入 GLTF 物件的某些欄位現在以大寫字母開始。 受影響的欄位會在其新名稱 () ：、、、 ModeTargetInterpolationMagFilterTypeWrapSMinFilterWrapT 。 PathComponentType

輸入動畫二進位檔具有更新的 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 專案，並選取音訊空間化工具

    選取音訊空間化程式

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

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

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

修正場景轉換設定檔

Oculus Quest

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

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

提示 XR 外掛程式錯誤

UnityUI 和 TextMeshPro

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

TMP 映射

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