練習 - 匯入和設定資源

已完成

安裝 Mixed Reality Feature Tool

若要將混合實境工具組匯入您的專案,您將使用混合實境功能工具。 此工具可讓開發人員探索、更新和匯入功能套件。 您可以依名稱或類別搜尋套件、查看其相依性,甚至在匯入之前查看專案資訊清單檔的建議變更。

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

  2. 下載完成之後,請開啟可執行檔 MixedRealityFeatureTool.exe ,並使用它來啟動混合實境功能工具。

    注意

    您必須先安裝 .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. 選取 [ 瀏覽 ] 按鈕(下圖 中的 ... 按鈕),流覽至您的項目,然後開啟它。

    Open your project

    選取資料夾之後,此工具會檢查以確定它是有效的 Unity 項目資料夾。

    Screenshot of the Mixed Reality feature Tool Project Path screen.

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

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

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

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

設定 Unity 專案

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

    Screenshot of Unity Restart Option.

  2. Unity 可能會要求您更新 XR InteractionLayerMask的方法。 選取 [ 我做了備份],[繼續! ] 按鈕,並等候 Unity 重新啟動。

    Screenshot of updating methods in the XR InteractionLayerMask.

  3. 在功能表欄上,選取 [編輯>專案 設定]。 選取 [XR 外掛程式管理]。 確定已選取 [啟動時初始化 XR],然後選取 [外掛程式提供者] 底下的 [開啟 XR] 複選框

    Screenshot of Initialize XR on Startup.

  4. OpenXR 外掛程式會載入,而兩個專案會出現在OpenXR底下。 核取第一個 Microsoft HoloLens 功能群組的方塊。 選取黃色 驚嘆號

    Screenshot of Open XR option.

  5. 選取 [全部修正]。

    Screenshot of Fix All.

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

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

  7. 在 [互動配置檔] 底下,選取 +,然後在尚未新增 Microsoft Hand Interaction Profile眼睛注視互動配置檔新增。

    Screenshot of Add Interaction Profiles.

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

  9. 選取眼睛注視互動配置檔的黃色驚嘆號,以帶回 [項目驗證] 視窗。 請確定您位於 [UWP 平臺] 索引標籤上(索引標籤會顯示 Windows 標誌),然後選取 [ 全部 修正] 來解決驗證問題。 請注意,某些問題可能仍然存在。 在此情況下,請再次選取 [ 全部 修正],忽略標示為 [場景特定] 的任何問題,然後閱讀其餘問題的建議(如果有的話),並進行任何您想要的變更。

  10. 在 [專案 設定] 視窗中,選取 MRTK3 並檢查是否有有效的配置檔。 如果沒有,請在專案的套件中搜尋 MRTKProfile (Packages/org.mixedrealitytoolkit.core/Configuration/Default Profiles/MRTKProfile.asset),並將它指派給配置檔。

    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. 選取 [發佈 設定] 下拉式清單,然後在 [套件名稱] 字段中輸入適當的名稱;例如 MRTK-Tutorials-Getting-Started

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

    注意

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

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

建立場景並設定 MRTK

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

  2. 在 [專案] 視窗中,流覽至 [套件>MRTK 輸入>資產>預製專案] 資料夾。 將預製物件 MRTK XR Rig 拖曳到場景階層中。

    Screenshot of the adding MRTK XR Rig in the Inspector.

  3. 拿掉Main 相機遊戲對象,因為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. 在功能表欄中,選取 [檔案另存新檔>]。

  6. 流覽至 [資產>場景] 資料夾,然後命名並儲存您的專案。