Microsoft Mixed Reality Toolkit 2.7 版本資訊

2.7.3 的新功能

來自 Redmond 的特殊感謝

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

我們也想要感謝朋友 Lachlan Ford 代表我們接受八月獎,並確保我們獲得獎的安全與音效。 2021 Auggie Awards Best Developer Tool

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已修正#10190LinePointer 的問題
  • 已修正具有非統一縮放問題的 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 版本。

Show version menu

MRTK version dialog

注意

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

Unable to determine version

作者清單

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

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

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

Configurator window with OpenXR setup instructions

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

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

2.7.0 的新功能

MRTK 現已正式支援 OpenXR

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

如果您要透過 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 管線的正確設定檔。

Legacy and XR SDK data providers can now be unified under a single profile

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

Null data providers are now hidden by defaultToggle show null data providers in the profile inspector

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

使用者現在可以設定Experience 設定,這可讓 MRTK 根據目標體驗適當地顯示Mixed Reality場景內容

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

Experience Scale Migration

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

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

Configurator showing the pipelines list

已培養的 Teleport 熱點

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

Teleport Hotspot example

已培養的 Dwell

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

Dwell hero

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

支援最新版 的 Leap Motion Unity 模組 現在與 MRTK 2.7.0 相容。 如需詳細資訊 ,請參閱如何設定 Leap Motion 的 MRTK

感謝 @jackyangzzh 參與新 LeapMotionOrientationExample 場景!

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

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

Speech Events with Far Pointers

TextToSpeech從 HTK 移植到 MRTK

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

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

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

Editor window showing two motion controller models

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

The hand mesh running on-device in an MRTK example scene

支援跨舊版 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 視覺效果與整合套件的視覺效果衝突。 #9589
  • 鍵盤相關腳本已變更為符合最新 Unity 版本 (2019.4.25+ & 2020.3.2+) 的行為。 從版本開始,仍然會有自動完成錯誤,而 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
  • 修正了 嘗試查詢不正確 reg 金鑰以取得Windows SDK 路徑的問題 BuildDeployWindow#9664
  • MRTK 的匯入 glTF 工具現在是選擇性的。 如果有多個 glTF 匯入工具存在,可以藉由將 MRTK_GLTF_IMPORTER_OFF 新增至自訂腳本定義符號來停用 MRTK。 #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 中的文字Mesh Pro畫布轉譯器警告

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

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

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