從新項目開始

2025-02-18

由於 MRTK3 是鬆散結合套件的集合，因此使用 MRTK3 的方式與使用 MRTK 2.x 的方式不同。我們不會以 Unity 專案的方式寄送 MRTK，因此您必須手動將 MRTK3 套件新增至您的專案，才能取用它們。

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

使用 MRTK3 設定新的 Unity 專案

1.建立新的 Unity 專案

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

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

MRTK3 使用的幾個套件不屬於此工具組。若要取得這些套件，請使用， Mixed Reality Feature Tool 然後在 [ 探索功能 ] 步驟中選取下列最新版本。

OpenXR 外掛程式 Mixed Reality 平台支援→
空間音訊→Microsoft空間化 工具 (選擇性)

針對 MRTK3 套件，強烈建議使用下列兩個套件，以協助您快速入門：

MRTK3 →此安裝程式所需的 MRTK 輸入 ()
MRTK3 → MRTK UX 元件

這兩個套件及其相依性 (功能工具) 自動新增，可讓您探索我們大部分的 UX 供應專案，並建立準備好部署到各種 XR 裝置的專案。您一律可以回到功能工具，並在稍後將更多套件新增至您的專案。

請務必選取 org.mixedrealitytoolkit.* 套件，而不是已淘汰的套件。套 com.microsoft.mrtk.* 件已被取代，不再支援。

在Microsoft的 Mixed Reality 功能工具中選取預設 MRTK3 套件

注意事項

如需 MRTK3 套件的詳細資訊，請參閱套件概觀頁面。

當您完成選取套件時，請按兩下 [取得功能]，然後遵循 Mixed Reality Feature Tool 中的指示，將選取的套件匯入您的 Unity 專案。

3.開啟 Unity 專案

開啟 Unity 專案，並等候 Unity 完成匯入新加入的套件。此程式中可能會有兩則快顯訊息：

第一則訊息會詢問您是否要啟用新的輸入後端。選 取 [是]。
第二則訊息會詢問您是否要更新 XR InteractionLayerMask。選取 [否感謝]。

Unity 可能會在此程式期間重新啟動幾次，等候它完成再繼續。

4.匯入後設定 MRTK 設定檔

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

流覽至 [編輯 > 項目設定]。
在 [項目設定] 底覽至 MRTK3 ，然後切換至 [獨立] 索引卷標。請注意，配置檔一開始未指定。
在欄位中填入核心套件隨附的預設 MRTK 設定檔。您可以在專案視窗的搜尋列中輸入關鍵詞「MRTKprofile」;請務必在中 All搜尋。或者，您可以在下 Packages/org.mixedrealitytoolkit.core/Configuration/Default Profiles/MRTKProfile.asset找到設定檔。

注意事項

並非所有 MRTK 子系統都會顯示在下列螢幕快照中。您看到的 MRTK 子系統可能會根據您已新增至專案的 MRTK3 套件而有所不同。
切換至您想要使用 (例如 UWP、Android) 等) 的其他建置目標 (索引標籤，並檢查配置檔是否已指派。如果沒有，請在目前的索引標籤上重複上一個步驟。

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

注意事項

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

流覽至 [編輯 > 項目設定]。
在 [項目設定] 底覽至 [XR 外掛程式管理]，然後在 [獨立] 和 [UWP] 索引卷標下啟用 OpenXR 。在每個索引標籤下，確定已選取 [在啟動時初始化 XR]，且已啟用 [獨立] 下的 [Windows Mixed Reality 功能群組] 和 [UWP] 下 Microsoft HoloLens 功能群組。

注意事項

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

針對獨立：

針對UWP：
在 [項目設定] 底覽至 [XR 外掛程式管理 > ] [OpenXR > 互動配置檔] ，然後針對 UWP 和獨立式新增下列三個配置檔：
- 眼部注視互動配置檔
- Microsoft手部互動配置檔
- Microsoft運動控制器配置檔
注意事項

您可能需要使用 OpenXR 專案驗證 工具來排除黃色三角形。某些警告可能會手動解決：
1.在 [項目設定] 底覽至 [播放器 > 解析度和簡報]。確定未核取 [在背景中 執行]。
2.針對 UWP，請在 [播放 > 機發佈設定 > 功能] 底下，確定如果應用程式需要這些功能，則會檢查 WebCam、 麥克風、 SpatialPerception 和 GazeInput 。如需視窗應用程式功能的詳細資訊，請參閱應用程式功能宣告。

針對獨立：

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