Microsoft Mixed Reality Toolkit 2.7 版本資訊

2.7.3 的新功能

來自 Redmond 的特殊感謝

MRTK 小組想要為您 MRTK 社群提供暖的感謝。 您的貢獻、意見反應和投票已協助 MRTK 贏得 2021 年 8 月最佳開發人員工具獎！ 如果沒有您的支持，我們不會是現今的所在位置。 無論是新增平台支援、新功能、錯誤修正、建議、問題或任何其他可能參與的方式：感謝您！

Unity 2021 支援

我們已使用 2.7.3 版，更輕鬆地在 Unity 2021 上建置！ 如果您在搭配 Unity 2021 使用 MRTK 時發現任何問題，請在 GitHub 存放庫上 提出問題 。

透過遠端支援 (僅限 OpenXR 的場景瞭解)

使用 OpenXR 平臺在 HoloLens 2 遠端處理期間，現在可以使用 Scene Understanding。

MRTK 2.7.3 錯誤修正和變更

• 除非配置檔已複製到該資料夾 #9916，否則停止建立CustomProfiles資料夾
• 已移除 GameObjects 的呼叫 .gameObject#9939
• 已修正具有停用元件的物件可能會導致指標變成鎖定焦點 的 Bug #9945
• 已更新 Unity 2021 #9938 已淘汰的方法和已修正編譯程序錯誤
• 已修正 link.xml Unity 2021 #9942
• 已更新按鈕組態偵測器以顯示圖示名稱 #9972
• 已更新控制器對應清單的標頭和對齊 方式 #9976
• MRTK 的各種 Unity 改善 #9940
• 已修正 BoundsControl 碰撞器問題和不一致 #9973
• 已修正按鈕圖示集偵測器 #9999
• 固定 BoundsControl 尺規控點碰撞器對齊 #10007
• 已修正 SDF 字型紋理分類 #10006
• 固定 BoundsControl 自動扁平化和尺規控點方向 #10013
• 已新增 BoundsControl 扁平化修正的意見反應 #10016
• 已修正動畫播放期間手部網格的奇怪現象 #10024
• 已修正記錄和 SpatialAwarenessSurfaceTypes 場景瞭解 #10026
• 已將獨立定義指示詞新增至 Leap 範例場景腳本 #10036
• 已修正在編輯器中指定非預設啟用類型時 所指定的 BoundsControlOnEnable 問題 #10039
• 已修正 OpenGL ES 和 Metal 的無效著色器位元組程式代碼錯誤 #10041
• 已新增 ClearProgressBar 呼叫以修正 Unity 2020 上的組建窗口凍結 #10046
• 已更新字型資產的串行化 #10047
• 已修正手部互動場景，讓適當的捏合滑桿碰撞器 #10060
• 固定表面磁力四元數數學 #10074
• 改善的 PV 相機版本訊息 #10077
• 已修正 BoundingBoxHelper.GetRawBoundsCorners 保護層級 #10093
• 已將 gLTF 匯入記錄更新為一個記錄，而不是多個 #10090
• 已從沒有 MRTK 的場景中移除 MRSceneContent 腳本 #10091
• 已從 Unity 2018 相容性的範例場景移除套件式事件系統 #10092
• 已移除預覽 Microsoft OpenXR 套件的支援 #10119
• 已修正接收數據時的應用程式凍結 #10033
• 已修正EyeTrackingTarget從 碰撞器傳遞至沒有 #10127 的碰撞器EyeTrackingTarget時，未觸發 OnLookAway
• 已變更預設指標範圍，讓滑鼠指標行為更直覺 #10075
• 更新摘要以釐清初始化執行的時間 #10177
• NullReferenceException已修正 #10190 中LinePointer的問題
• 已修正具有非統一縮放問題的 BoundsControl#10133
• 已修正在不同文化特性中的 處理 IOSMinOSVersion#10178
• 已從啟用眼睛注視的物件中移除額外的光線廣播 #10162
• 在MixedRealityToolkit預製專案 #10180 的編輯器偵測器中將滑鼠停留在各種配置檔上時新增工具提示
• 已修正語音命令下拉式清單，並更新 EyeTrackingExample #10197 中的命令
• 已修正使用 Unity 標準著色器載入時，『gLTF』 對象顯示為黑色 #10209
• 已修正UnityTouchDeviceManager 屬性為 false 時 IsEnabled 更新本身 #10203
• 已更新按鈕組態協助程式中的屬性名稱 #10221
• 固定物件匯出工具中的座標空間、繞線順序及文化特性格式 #10208
• 已新增將掌握點移至指尖 的選項 #10206
• 已新增 Leap UnityModules 4.9.1 #10282 的支援
• 向後移植 #10280 的一些次要變更ReserializeAssetsUtility.cs
• 已將 不正確的使用方式 enumValueIndex 轉換為 intValue#10274
• 固定物件在接近操作期間漂移 #10294
• 已修正界限控件會積極移除其他元件 #10296 的情況
• 已修正閃爍鄰近光源 #10325
• 已新增檢查以查看是否有任何專案已連結至事件，再判斷引發這些事件 #10330
• 已變更各種次要專案 #10316
• 引進 HasFlag #10319 的替代方案
• 減少 HandConstraint 規劃求解偵錯記錄垃圾郵件 #10331
• 已修正來自 HandConstraintPalmUp.cs#10326 的記錄垃圾郵件
• 已啟用透過OpenXR進行全像攝影遠端處理的場景瞭解 #10338
• 已將無參數建構函式新增至 InteractableOnClickReceiver #10353
• 將 FingerChaser 預製專案移至範例套件中的 Common 資料夾 #10358
• 已針對OpenXR上的明確手部選取新增後援案例 #10359
• 已修正 Windows Mic Stream 示範 UPM 匯入問題 #10362
• 已重新命名的 OpenXR 配置檔 #10363
• 已改善 Unity 2021 的 Raycast 點擊記錄輸出，並在使用 AssetBundles #10370 時修正當機
• 已將字串更新為 const 和快取類型，以減少配置 #10369
• 已修正使用以應用程式為基礎的全像攝影遠端 #10366 時以 XRSDK 為基礎的網格觀察者
• 整合式 0067 視覺效果 #10067
• 已新增 BoundsControl 屬性的檔 #10361
• 固定手部聯合追捕器預製專案 #10377
• 已修正 10374 的部署錯誤
• 已修正 Scene Understanding 範例場景配置檔 #10368 的問題
• 已修正在最新版 Unity 2021.2 #10182 中匯入時的 MRTK 控制台錯誤
• 新增了有關如何變更數據指標的遺漏檔 #4934
• 已改善 MRTK Unity 套件發行頁面上的指示，使其更清楚 #9575
• 已修正 MicStream 選取示範場景未處理 (UPM 套件) #9908 的問題
• 已修正無法在 MRTK 範例套件中個別匯入範例的問題 #10216
• 已新增部分屬性的 BoundsControl 遺漏檔 #10346
• 已修正無法將 InteractableOnClickReceiver 新增至具有可互動元件的遊戲物件 #10341 的錯誤

2.7.2 的新功能

已修正 UPM 套件相依性問題

MRTK 2.7.1 UPM 套件發生問題，其中相依性未正確設定。 此問題會導致 Mixed Reality 功能工具無法正確匯入 MRTK 2.7.1 套件。 問題現在已在 2.7.2 中解決。 相較於 2.7.1，此版本沒有程式代碼變更。

2.7.1 的新功能

顯示版本

[Mixed Reality > 工具組] 功能表現在包含 [顯示版本...] 專案，此專案會檢查 Mixed Reality Toolkit Foundation 套件，以判斷專案正在使用的 MRTK 版本。

注意

如果從 GitHub 存放庫複製 MRTK，則不會設定版本資訊。

作者清單

從 MRTK 2.7.1 開始，作者清單檔案會包含在 Mixed Reality Toolkit Foundation 套件中。

將 OpenXR 專案設定整合到 Configurator 設定流程中

從 MRTK 2.7.1 開始，Mixed Reality OpenXR 外掛程式的使用者會收到如何使用 MRTK 設定該外掛程式的指示。 有一個選項可供以 HoloLens 2 為目標的用戶自動套用建議的設定。

值得注意的錯誤修正和變更

• 在 XR SDK 管線 #9954、 #9994 上將 Unity 遊戲桿管理員標示為支援
• 已將檢查新增至可互動的偵測器程序代碼，以防止 Null 錯誤 #9943
• 將OpenXR網格提供者新增至脈衝著色器範例場景 #9902
• 將手部物理配置檔還原至範例場景 #9915
• 腳本的 HandConstraint 一些清除 #9935
• 已修正影響建立和複製配置檔的一些錯誤 #9982

2.7.0 的新功能

MRTK 現已正式支援 OpenXR

隨著新的 OpenXR 外掛程式變得更成熟，MRTK 現在正式支援 OpenXR。 相較於舊版，我們已使用 OpenXR 將下列功能新增至專案：

• 支援系統提供的動作控制器模型
• (選取、保留、操作和流覽) #9843 支援 WinMR 手勢
• 支援控制器觸覺
• 支援在 HoloLens 2 上表達的手部網格
• HoloLens 2 #9567、#9827 上的空間對應支援
• HoloLens 2 #9744 上的 Scene Understanding 支援

如果您是透過OpenXR HoloLens 2 或 Windows Mixed Reality 頭戴式裝置為目標，請務必透過 Mixed Reality Feature Tool安裝/更新至 Mixed Reality OpenXR 外掛程式0.9.5版或更新版本，否則您可能會錯過上述一些改善。

舊版 XR 和 XR SDK 資料提供者現在可以在相同的配置檔中使用

現在，只有在選取適當的管線時，才會載入數據提供者，讓舊版 XR 和 XR SDK 資料提供者同時存在於相同的配置檔中。 為了配合此情況，舊版 XR 和 XR SDK 數據提供者現在會組織在配置文件檢視內的不同索引標籤之下。 此組織應該協助判斷是否已針對目標 XR 管線選取正確的配置檔。

為了容納這種情況，Null 數據提供者現在將不再載入並顯示在配置檔偵測器中。 使用者可以在 [編輯 -> 項目設定 -> Mixed Reality 工具組] 下切換Show null data providers in the profile inspector，以偵錯遺漏數據提供者的非預期行為。

已新增體驗設定和相關聯的 Mixed Reality 場景內容行為

用戶現在可以設定 [體驗設定]，這可讓 MRTK 根據目標體驗適當地顯示 Mixed Reality 場景內容。

如果使用者先前的體驗調整設定不符合新的 [體驗設定配置檔]，系統會提示他們在偵測器中更正它。

重新設計的 Configurator 現在會引導使用者完成設定程式

新的 MRTK Configurator 可為使用者提供逐步指引，以正確設定 XR 開發的專案，並搭配 MRTK 使用。 其中涵蓋 XR 管線的選擇、取得平臺特定的外掛程式、匯入 TextMeshPro、在使用 UPM) 時顯示範例 (，以及其他先前包含的專案建議設定。

已培養的 Teleport 熱點

新的 遠端傳輸熱點元件 已定型。 您可以將遠端傳送熱點新增至您的 GameObject ，以確保使用者在傳送至該位置時處於特定位置和方向。

已培養的 Dwell

暫留功能和範例現在已從實驗性中升級。 範例場景中包含磁碟區 HoloLens 2 樣式按鈕的新範例。

已新增 Leap Motion Unity 模組 4.6.0、4.7.0、4.7.1 和 4.8.0 版的支援

支援最新版 的 Leap Motion Unity 模組 現在與 MRTK 2.7.0 相容。 如需詳細資訊，請參閱 How to Configure MRTK for Leap Motion。

@jackyangzzh感謝參與新LeapMotionOrientationExample場景！

目標語音事件不再受限於注視指標

先前，目標語音事件只能引發於以注視指標為焦點的物件上。 現在，如果物件是以任何指標為焦點，就可以接收語音事件。

TextToSpeech從 HTK 移植到 MRTK

現在 MRTK 中已提供所愛 TextToSpeech 的腳本，可協助您使用 SpeechSynthesizer從 UWP 平臺上的文字產生語音。 此外，也新增了範例場景來示範此功能。

在 OpenXR 上支援系統提供的動作控制器模型

已針對 OpenXR 上的系統提供的動作控制器模型，在編輯器內和運行時間新增支援。

在 OpenXR 上支援 HoloLens 2 清楚的手部網格

支援跨舊版 WMR、Windows XR 外掛程式和 OpenXR 的控制器觸覺

已新增跨舊版 WMR、Windows XR 外掛程式和 OpenXR 的控制器觸覺支援。 #9735

支援 Windows XR 外掛程式上的眼球追蹤

新增使用 Windows XR 外掛程式最低版本 2.7.0 (Unity 2019) 、4.4.2 (Unity 2020) 和 5.2.2 (Unity 2021) 的支援。 #9609

值得注意的錯誤修正和變更

• 捏合偵測更順暢。 現在很難不小心卸除捏合手勢。 #9576
• 具有 Object Manipulator 元件的物件現在會在設定旗標時持續維持釋放的速度。 #9733
• 上層現在會檢查樓層，協助防止相機可以裁剪到環境或使用者停留在空白空間的情況。#9697
• IsNearObject 現在是虛擬屬性，可在擴充球體或點選指標時提供更多彈性。 #9803
• 按鈕現在會在顯示可用的語音命令時顯示適當的關鍵詞。 #9824
• 控制器現在使用自己的獨立可視化檢視，防止 MRTK 視覺效果與 0s 整合套件的視覺效果衝突。 #9589
• 鍵盤相關腳本已變更，使其符合最新 Unity (2019.4.25+ & 2020.3.2+) 的行為。 自發行開始，仍有自動完成 Bug 和 TMP 輸入欄位錯誤， (兩者都位於 MRTK 外部，) 影響 HoloLens。 如需詳細資訊，請參閱 #9056 和 #9724。
• 改善 Scrolling 物件集合的效能。 也修正了在複製時，集合內遺失 GameObject 材質的問題。 #9813， #9718
• 在 Scene Understanding 示範腳本中，新增 函 GetSceneObjectsOfType 式以擷取特定種類的所有觀察場景物件。 #9524， #9744
• 在命令行建置工具中，只有在組建中包含任何旗標) 時，或 sceneListFile 旗標所sceneList指定的場景才會 (。 #9695
• 在建置工具中，有一個新選項可用來指定路徑 nuget.exe ，並使用 來執行套件還原，而不是使用 msbuild (默認選項) 。 #9556
• 已修正使用 Windows XR 外掛程式可能會導致過時的手部接合和雙手網格的問題。 #9890
• 已修正使用 Windows XR 外掛程式的自動遠端功能會導致遺漏輸入和互動的問題。 #9868
• 已修正 嘗試查詢 Windows SDK 路徑無效的註冊金鑰的問題 BuildDeployWindow 。 #9664
• MRTK 的匯 glTF 入工具現在是選擇性的。 如果有多個 glTF 匯入工具存在，可以藉由將 MRTK 新增 MRTK_GLTF_IMPORTER_OFF 至自定義腳本定義符號來停用。 #9658
• 已修正未正確偵測 OpenVR 上的 Knuckles 控制器的問題。 #9881
• 在視覺化手部網格 #9756 時減少個別畫面配置的數目
• 已新增功能表項以在 Unity 套件管理員中啟動 MRTK 範例套件 () ，讓您更輕鬆地匯入範例 #9798
• 使用 Unity 2020.3 時，減少載入時間警告的數目。
• 新增建置視窗功能檔： 瀏覽頁面

已知問題

音訊示範遺漏 asmdef UPM 套件 (檔案)

透過 Mixed Reality 功能工具匯入 MRTK 時，會使用 Unity 套件管理員 UI 將範例和示範新增至專案。 匯入音訊示範之後， WindowsMicrophoneStreamDemo.unity 場景將無法正常運作。 此行為是範例遺漏 asmdef 檔案的結果。

若要 解決此問題，請執行下列步驟：

• 複製連結庫/PackageCache/com.microsoft.mixedreality.toolkit.examples@[...]/MRTK。Examples.asmdef 到 [資產/範例/Mixed Reality 工具組範例] 資料夾中
• 將複製的檔案重新命名為範例
• 開啟範例檔案
• 在 [名稱] 方塊中，以範例取代內容
• 按兩下 [套用]
• 建置及部署

此問題將在即將推出的 MRTK 版本中修正。

UNITY 2020.3 中的 MRTK 建置視窗會觸發無限期的 [匯入資產] 對話框

Unity 2020.3 上的 MRTK 組建視窗有已知 問題 ，其中 [匯入資產] 對話框在 UWP 組建之後不會完成。 此問題正在 Unity 中調查。

Unity 2020 中的文字網格 Pro 畫布轉譯器警告

使用 Unity 2020 時，下列警告會記錄在大部分 MRTK 範例場景中：

Please remove the `CanvasRenderer` component from the [TextMeshPro] GameObject as this component is no longer necessary.

TextMeshPro 3.0.3 版中已新增 Canvas 轉譯器警告。 這些警告不會影響 MRTK 的範例場景，而且可以從控制台清除。 如需詳細資訊，請參閱 問題 9811。