練習 - 匯入和設定資源

已完成

安裝 Mixed Reality Feature Tool

為了將 Mixed Reality Toolkit 匯入專案,我們將使用 Mixed Reality Feature Tool,讓開發人員能夠探索、更新和匯入功能套件。 您可以依名稱或類別搜尋套件、查看其相依性,甚至在匯入之前查看專案資訊清單檔的建議變更。

  1. 請從 Microsoft 下載中心下載最新版 Mixed Reality Feature Tool。

  2. 下載完成後,開啟 MixedRealityFeatureTool.exe 檔案,然後加以使用來啟動 Mixed Reality Feature Tool。

    注意

    您必須先安裝 .NET 6.0 執行階段,才能執行 Mixed Reality Feature Tool。

匯入 MRTK Unity Foundation 套件

  1. 在 [Mixed Reality Feature Tool] 中,選取 [Start] \(啟動\)。

    Screenshot of the Mixed Reality Feature Tool opening screen.

  2. 選取 [瀏覽] 按鈕 (下圖中的「三個點」按鈕),然後瀏覽至專案,然後將其開啟。

    Screenshot of the Select Project screen.

    選取資料夾之後,工具會檢查其是否為有效的 Unity 專案資料夾。

    Screenshot of the Mixed Reality feature Tool Project Path screen.

  3. 選取 [Discover Features] \(探索功能\)。

    注意

    當工具從摘要重新整理套件時,您可能需要等候幾秒鐘。

  4. 在 [Discover Features] \(探索功能\) 頁面上,請注意有可用套件群組的清單。

    Screenshot of the main groups of packages in the Mixed Reality Feature Tool.

  5. 按一下 +Platform Support (0/5) (平台支援 (0/5)) 左側的 "+" 按鈕,然後選取最新版本的 Mixed Reality OpenXR Plugin (Mixed Reality OpenXR 外掛程式)。

    Screenshot of package selections in the Mixed Reality Feature Tool.

  6. 選取 MRTK3 右側的 [全選] 按鈕,以選取所有功能。

    Screenshot of selecting all feature of MRTK3.

    注意

    如果您看到標示為已淘汰的任何套件,您應該將其移除,並確定已取消選取 Settings (設定) > Feature (功能) > Show deprecated packages (顯示已淘汰的套件)

  7. 選取之後,按一下 Get Features (取得功能)。

  8. 選取 [Validate] \(驗證\) 以驗證您選取的套件。 您應該會看到一個對話方塊,指出 [No validation issues were detected] \(未偵測到任何驗證問題\)。 完成時,選取 [確定]。

  9. Import Features (匯入功能) 頁面上,左側資料行 Features (功能) 會顯示您剛才選取的套件。 右側資料行 [Required dependencies] \(必要相依性\) 會顯示任何相依性。 您可以按一下這些項目的 Details (詳細資料) 連結,以深入了解這些項目。

  10. 當您準備好繼續進行時,請選取 [Import] \(匯入\)。在 [Review and Approve] \(檢閱並核准\) 頁面上,您可以檢閱套件的相關資訊。

  11. 選取 [核准]。

  12. 選取 [結束]。

  13. 返回 Unity Editor,然後按一下 UI 中的空白區域。 您會看到進度列,其中顯示系統正在匯入套件。

設定 Unity 專案

  1. 在 Unity 匯入套件之後,會出現警告,詢問您是否要重新啟動編輯器來啟用後端。 選取 [是] 。

    Screenshot of Unity Restart Option.

  2. Unity 會要求您更新 XR InteractionLayerMask 中的方法、選取 I Made a Backup, Go Ahead! (我已完成備份,繼續執行!) 按鈕,並等候 Unity 重新啟動。

    Screenshot of updating methods in the XR InteractionLayerMask.

  3. 在功能表列上,選取 Mixed Reality (混合實境)> Project (專案) > Apply recommended project settings for HoloLens 2 (套用 HoloLens 2 的建議專案設定)

  4. 在功能表列上,選取 Edit (編輯) >Project Settings...(專案設定...)。選取 XR Plugin-in Management (XR 外掛程式管理)。 確定已選取 Initialize XR on Startup (啟動時初始化 XR),然後在 Plugin Providers (外掛程式提供者) 下,按一下 Open XR (開啟 XR)。

    Screenshot of Initialize XR on Startup.

  5. OpenXR 外掛程式會載入,然後兩個項目會出現在 OpenXR 下方。 選取第一個項目:[Microsoft HoloLens feature group] \(Microsoft HoloLens 功能群組\)。 選取黃色驚嘆號。

    Screenshot of Open XR option.

  6. 選取 [全部修正]。

    Screenshot of Fix All.

    部分警告可能仍然存在。 現在請忽略這些警告。

  7. 選取 XR Plug-in Management (XR 外掛程式管理) 底下的 OpenXR

  8. Interaction Profiles (互動設定檔) 下,如果未新增,請新增 Microsoft Hand Interaction and Eye Gaze Interaction Profile (Microsoft 手部互動和眼球注視互動設定檔)。

    Screenshot of Add Interaction Profiles.

  9. 確定已選取左側的 Microsoft Hololens,以及右側的 Hand Tracking (手部追蹤)、Mixed Reality Features (混合實境功能) 和 Motion Controller Model (運動控制器模型)。

  10. 選取 Eye Gaze Interaction Profile (眼球注視互動設定檔) 旁的警告符號,以回到 Project Validation (專案驗證) 視窗。 確定您位於 UWP platform (UWP 平台) 索引標籤 (顯示 Windows 標誌的索引標籤),然後選取 Fix All (全部修正) 以解決驗證問題。 請注意,在您按一下 Fix All (全部修正) 之後,可能仍會有問題存在。 在此情況下,再按一下 Fix All (全部修正),忽略標示為 Scene specific (場景特定) 的任何問題,然後閱讀其餘問題的建議 (如果有),並進行任何您想要的變更。

  11. Project Settings (專案設定) 底下,選取 MRTK3,檢查是否有有效的設定檔。 如果沒有,請在專案的套件 (Packages/org.mixedrealitytoolkit.core/Configuration/Default Profiles/MRTKProfile.asset) 中搜尋 MRTKProfile,並將它指派給設定檔。

    Screenshot of MRTK profile.

設定專案設定

  1. 在功能表中,選取 Edit (編輯) >Project Settings (專案設定)。

  2. 在 [Project Settings] \(專案設定\) 視窗的左側資料行中,選取 [Player] \(玩家\)。

  3. 請注意,在 [播放機] 視窗中,產品名稱為「MRTK 教學課程」。此名稱取自專案名稱,且將會是 HoloLens [開始] 功能表中顯示的名稱。

    Screenshot of Unity Publishing Settings with the Project Name box filled in.

    提示

    若要在開發期間更容易找到應用程式,請在名稱前面加上底線,將其排序到任何清單的頂端。

  4. 選取 Publishing Settings (發佈設定) 下拉式清單,然後在 Package name (套件名稱) 欄位中輸入適當的名稱,例如 MRTK-Tutorials-Getting-Started

    Screenshot of Unity Publishing Settings with the package name box filled in.

    注意

    套件名稱是應用程式的唯一識別碼。 如果您想要避免以相同名稱覆寫先前安裝的應用程式版本,則應該在部署應用程式之前變更此識別碼。

  5. 關閉 [Project Settings] \(專案設定\) 視窗。

建立場景並設定 MRTK

  1. 在功能表列上,選取 [File] \(檔案\)>[New Scene] \(新增場景\)。 選取 Basic (Built-in) (基本 (內建)) 選項,然後選取 Create (建立)。

  2. 在 Project (專案) 視窗中,瀏覽至 Packages (套件)>MRTK Input (MRTK 輸入) >Assets (資產) >Prefabs (預製物件) 資料夾。 將預製物件 MRTK XR Rig 拖曳到場景階層中。

    Screenshot of the adding MRTK XR Rig in the Inspector.

  3. 移除 Main Camera (主要相機) 遊戲物件,因為 MRTK XR Rig 遊戲物件已經包含相機。

    Screenshot of the Mixed Reality Toolkit in the Inspector.

  4. MRTK Input Simulator (MRTK 輸入模擬器) (Packages (封裝) >MRTK Input (MRTK 輸入) >Simulation (模擬) >Prefabs (預製物件)) 預製物件新增至場景。

    注意

    此步驟是選用的,但編輯器內模擬需要。

    Screenshot of the input simulator.

  5. 在功能表列中,選取 [File] \(檔案\)>[Save As] \(另存新檔\)。

  6. 瀏覽至 [Assets]>[Scenes] 資料夾,並為專案命名,然後儲存專案。