MRTK3 的初始設定

歡迎使用 MRTK3 公開預覽版！ 由於 MRTK3 是鬆散結合套件的集合，因此使用 MRTK3 的方式與取用 MRTK 2.x 的方式不同。 我們不會將 MRTK 寄送為 Unity 專案，因此您應該使用我們的範例範本專案，這是預先設定來取用所有 MRTK 套件， (更容易開始使用) ，或開始使用新的專案， (提供您更多控制權，建議) 。

您不預期會取用每個 MRTK 套件。 查看 哪些功能對您很有用 ，並只新增重要的相依性。

安裝工具

開始之前，請確定您有此連結中的所有工具：

安裝工具

路徑 1：複製存放庫並試用範例 Unity Project

取得和試用 MRTK3 最簡單的方式，就是透過預先設定的專案，並參考所有目前的 MRTK3 套件。 請在GitHub存放庫複製專案，並簽出 mrtk3 分支。 之後，您只要在專案底 UnityProjects 下 MRTKDevTemplate 啟動 Unity (2020.3.33f1 或更新版本) ，然後透過遠端或部署至裝置開始在編輯器中播放範例場景即可。

如需預覽中包含的範例場景資訊，請參閱 使用和建立場景。

路徑 2：將 MRTK3 新增至新的 Unity 專案

1.建立新的 Unity 專案

使用 Unity 2020.3.35f1 或更新版本 /Unity 2021.3.4f1 或更新版本建立新的 Unity 專案。 請先關閉 Unity 專案，再繼續進行下一個步驟。

2.使用 Mixed Reality 功能工具匯入必要的相依性和 MRTK3 套件

MRTK3 使用的幾個套件不屬於此預覽版。 若要取得這些專案，請使用 Mixed Reality Feature Tool ，並在 [探索功能] 步驟中選取下列最新版本：

• → Mixed Reality OpenXR 外掛程式的平臺支援
• [選擇性] 空間音訊→ Microsoft Spatializer

針對 MRTK3 套件，請參閱套件概 觀頁面 以取得套件的相關資訊，然後選取符合您需求的套件。

當您完成選取套件時，請按一下 [取得功能]，然後依照 [Mixed Reality功能工具] 中的指示，將選取的套件匯入 Unity 專案中。

3.開啟 Unity 專案

開啟 Unity 專案，並等候 Unity 完成匯入新增的套件。 此程式中可能有兩個快顯視窗：

1. 第一個快顯視窗會詢問您是否要啟用新的輸入後端。 選取 [是]。
2. 第二個快顯視窗會詢問您是否要更新 XR InteractionLayerMask。 選取 [否感謝]。

Unity 可能會在此程式期間重新開機數次，等待它完成再繼續。

4.匯入後設定 MRTK 設定檔

匯入之後，MRTK3 需要針對獨立和每個額外的目標平臺設定設定檔。

1. 流覽至[編輯 > Project 設定]。

2. 在[Project 設定] 底下，流覽至MRTK3並切換至 [獨立] 索引標籤。請注意，設定檔一開始未指定。

3. 使用隨附核心套件的預設 MRTK 設定檔填入欄位。 您可以在專案視窗的搜尋列中輸入關鍵字 「MRTKprofile」 ;請確定您在 中 All 搜尋 。 或者，您可以在 下 Packages/com.microsoft.mrtk.core/Configuration/Default Profiles/MRTKProfile.asset 找到設定檔。

   注意

   並非所有 MRTK 子系統都會顯示在下列螢幕擷取畫面中。 您看到的 MRTK 子系統可能會根據您新增至專案的 MRTK3 套件而有所不同。

   

4. 切換至其他組建目標的索引標籤， () 您想要使用 (例如 UWP、Android) ，並檢查是否已指派設定檔。 如果沒有，請在目前的索引標籤上重複上一個步驟。

5.設定 OpenXR 相關設定

匯入之後，如果您要以 XR 裝置為目標，例如 HoloLens 2 或 Quest，MRTK3 在 OpenXR 上需要一些設定。

注意

下列指示適用于HoloLens 2或 WMR 頭戴式裝置。 如果您是以 Quest 為目標，請參閱 Quest 部署頁面上的指示。

1. 流覽至[編輯 > Project 設定]。

2. 在[Project 設定] 底下，流覽至[XR 外掛程式管理]，並在 [獨立] 和 [UWP] 索引標籤下啟用OpenXR。 在每個索引標籤下，確定已選取 [啟動時初始化 XR]，且 [獨立] 底下的 [Windows Mixed Reality] 功能群組，以及[UWP] 底下的 [Microsoft HoloLens] 功能群組已啟用。

   注意

   檢查 OpenXR 選項之後，可能會出現黃色警告圖示。 按一下該圖示以開啟OpenXR Project 驗證工具。 按一下 [全部修正 ]，並忽略無法自動修正的互動設定檔問題。 設定檔將會在下列步驟中新增。

   針對獨立：

   

   針對 UWP：

   

3. 在[Project 設定] 底下，流覽至[XR 外掛程式管理 > OpenXR > 互動設定檔]，然後新增下列三個 UWP 和獨立設定檔：

   • 眼球注視互動設定檔
   • Microsoft Hand 互動設定檔
   • Microsoft 動作控制器設定檔

   注意

   您可能需要使用OpenXR Project驗證工具來消除黃色三角形。

   注意

   您可能需要使用OpenXR Project驗證工具來消除黃色三角形。

   針對獨立：

   

   針對 UWP：

   

4. 針對HoloLens 2，建議您在上述設定中將深度提交模式設定為 16 位。 針對沉浸式頭戴式裝置，您可以使用 24 位深度提交。 如需詳細資訊 ，請參閱適用于 Unity 的 Microsoft 開發檔 。

6.恭喜，專案設定現在已完成！

請繼續 建立新的 MRTK3 場景。

後續步驟

• 試用我們的範例場景或建立您自己的場景