使用 MRTK3 套件

Microsoft MRTK3 會以一組套件的形式散發,這些套件會使用適用于 Unity 的 Mixed Reality Feature Tool 和 Unity 封裝管理員 (UPM) 匯入 Unity。 這些套件可讓開發人員自訂其專案內的 MRTK。

注意

針對 MRTK3 私人預覽版,將不會使用Mixed Reality功能工具。 如需匯入 MRTK 套件的詳細資訊,請檢閱 初始設定

相依性

某些 MRTK3 套件需要 Microsoft 和/或 Unity 提供的額外套件,才能正確運作。 其中有些套件是選擇性的,而且會啟用其他功能。

下圖說明 MRTK 套件與部分 Unity 相依性之間的關聯性。

MRTK3 Package Graph

注意

使用Mixed Reality功能工具匯入套件時,會自動執行相依性管理。

下表描述Mixed Reality Toolkit 套件相依性。

顯示名稱 套件名稱 描述 必要 選用
MRTK 核心定義 com.microsoft.mrtk.core 共用定義、公用程式和元件。
  • com.unity.xr.interaction.toolkit
  • com.unity.xr.management
MRTK 協助工具 com.microsoft.mrtk.accessibility 用於建置可存取混合實境體驗的定義、功能和子系統。
  • com.microsoft.mrtk.core
  • com.microsoft.mrtk.graphicstools.unity
  • com.unity.textmeshpro
MRTK 資料系結和主題 com.microsoft.mrtk.data 支援資料系結和 UI 元素主題。
  • com.microsoft.mrtk.core
  • com.unity.nuget.newtonsoft-json
  • com.unity.textmeshpro
MRTK 診斷 com.microsoft.mrtk.diagnostics 診斷和效能監視子系統和工具。
  • com.microsoft.mrtk.core
  • com.unity.xr.management
MRTK 環境 com.microsoft.mrtk.environment 環境功能和子系統,例如空間感知和界限。
  • com.microsoft.mrtk.core
  • com.unity.xr.management
MRTK 擴充資產 com.microsoft.mrtk.extendedassets 用於應用程式的其他音訊、字型、紋理和其他資產。
  • com.microsoft.mrtk.standardassets
  • com.microsoft.mrtk.graphicstools.unity
MRTK 輸入 com.microsoft.mrtk.input 輸入元件,包括支援已表達的手部、離線語音辨識和編輯器內輸入模擬。
  • com.microsoft.mrtk.core
  • com.microsoft.mrtk.graphicstools.unity
  • com.unity.xr.interaction.toolkit
  • com.unity.inputsystem
  • com.unity.xr.management
  • com.unity.xr.openxr
  • com.unity.xr.arfoundation
MRTK 空間操作 com.microsoft.mrtk.spatialmanipulation 空間定位和操作元件和公用程式,包括解算器。
  • com.microsoft.mrtk.core
  • com.microsoft.mrtk.uxcore
  • com.unity.inputsystem
  • com.unity.xr.interaction.toolkit
  • com.microsoft.mrtk.input
MRTK 標準資產 com.microsoft.mrtk.standardassets 標準資產,包括材質和紋理,可供應用程式使用。
  • com.microsoft.mrtk.graphicstools.unity
MRTK UX 元件 com.microsoft.mrtk.uxcomponents MRTK UX 元件庫,包含預製專案、視覺效果、預先建立的控制項,以及開始為混合實境建置 3D 使用者介面的所有專案。
  • com.microsoft.mrtk.uxcore
  • com.microsoft.mrtk.spatialmanipulation
  • com.microsoft.standardassets
  • com.microsoft.mrtk.data
MRTK UX 核心 com.microsoft.mrtk.uxcore 建置 MR 使用者介面元件的核心互動和視覺效果腳本。\n\n注意:這是為了建置 UX 程式庫而取用。 若要使用元件預先存在的程式庫建置 MR 介面,請參閱 com.microsoft.mrtk.uxcomponents。
  • com.microsoft.mrtk.core
  • com.microsoft.mrtk.graphicstools.unity
  • com.unity.inputsystem
  • com.unity.textmeshpro
  • com.unity.xr.interaction.toolkit
  • com.microsoft.mrtk.data
MRTK Windows語音 com.microsoft.mrtk.windowsspeech 原生Windows語音 API 的語音子系統實作。 允許使用原生Windows語音辨識來引發事件並驅動 XRI 互動。
  • com.microsoft.mrtk.core

執行套件測試

某些 MRTK 套件包含用來驗證內含元件的測試。 在某些情況下,這些測試需要其他未判斷提示為相依性的 MRTK 套件。

注意

將套件匯入 Unity 時,預設不會編譯測試元件。 若要啟用測試的編譯,請使用 testables 專案 manifest.json 檔案的 元素。

為了在匯入Mixed Reality工具組的應用程式上放置最少的額外負荷,只會針對執行時間需求判斷提示相依性。 下表描述啟用編譯和執行內含測試元件所需的其他套件。

顯示名稱 套件名稱 測試需求
MRTK 核心定義 com.microsoft.mrtk.core
MRTK 協助工具 com.microsoft.mrtk.accessibility
MRTK 資料系結和主題 com.microsoft.mrtk.data
MRTK 診斷 com.microsoft.mrtk.diagnostics
MRTK 環境 com.microsoft.mrtk.environment
MRTK 擴充資產 com.microsoft.mrtk.extendedassets
MRTK 輸入 com.microsoft.mrtk.input
MRTK 空間操作 com.microsoft.mrtk.spatialmanipulation
  • com.microsoft.mrtk.input
MRTK 標準資產 com.microsoft.mrtk.standardassets
MRTK UX 元件 com.microsoft.mrtk.uxcomponents
  • com.microsoft.mrtk.input
MRTK UX 核心 com.microsoft.mrtk.uxcore
  • com.microsoft.mrtk.input
MRTK Windows語音 com.microsoft.mrtk.windowsspeech