共用方式為


將 Unity 2019 專案移轉至 Unity 2020 + OpenXR

為了順利進行移轉,建議您依照所呈現的順序完成本文中的所有步驟。 以下是主要步驟的概觀:

  1. 將 MRTK 更新為最新的穩定版本。
  2. 將您的專案移至 Unity 2019 XR 外掛程式管理。
  3. 選擇 [Windows Mixed Reality]。
  4. 升級至 Unity 2020.3 LTS。
  5. 使用 Mixed Reality Feature Tool 來安裝更多套件。
  6. 設定 OpenXR 的 XR 外掛程式管理。

1.將 MRTK 更新為最新的穩定版本

如果您已經使用 MRTK,建議您移轉的第一個步驟是執行Mixed Reality功能工具,並更新為最新的穩定版 MRTK。

選取您想要的功能

注意

本節中的描述和映射是以最新版的工具為基礎。 如果指示不符合您看到的內容,請檢查以確定您不是使用舊版的工具。

  1. 開啟 Microsoft Mixed Reality 功能工具,然後按一下 [開始] 按鈕。

    混合實境功能工具

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

    開啟您的專案

  3. 選取 [探索功能]。

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

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

    Mixed Reality Feature Tool 中套件的主要群組

  5. 按一下[工具組] 左側 Mixed Reality的 [+] 按鈕,然後選取最新版的 Mixed Reality Toolkit Foundation

匯入功能

  1. 選取之後,按一下 [Get Features] \(取得功能\)。
  2. 在 [Import Features] \(匯入功能\) 頁面上,左側資料行 [Features] \(功能\) 會顯示您剛才選取的套件。 右側資料行 [Required dependencies] \(必要相依性\) 會顯示任何相依性。 您可以按一下這些項目的 [Details] \(詳細資料) 連結,以深入了解這些項目。
  3. 當您準備好繼續進行時,請選取 [Import] \(匯入\)。在 [Review and Approve] \(檢閱並核准\) 頁面上,您可以檢閱套件的相關資訊。
  4. 選取 [核准]。 功能工具會顯示一則訊息,指出您的專案已更新。
  5. 返回 Unity Editor,然後按一下 UI 中的空白區域。 您會看到一則訊息,告訴您正在匯入套件。

藉由在仍在使用 Unity 2019 時執行這項升級,您可以檢視 MRTK Project Configurator,並查看關於如何取得最新狀態的任何「已淘汰 API」警告。 警告會告訴您要變更的內容。 如果您未先進行此 MRTK 升級,舊的 API 可能會消失,而且您不會有這些警告。

深入瞭解Mixed Reality功能工具

2.將您的專案移至 Unity 2019 XR 外掛程式管理

更新 MRTK 之後,您可以指示 Unity 2019 使用 XR 外掛程式管理。

  1. 在功能表列的 Unity 編輯器中,選取[編輯>專案設定]。
  2. 在 [ 專案設定 ] 視窗的左側資料行中,選取 [XR 外掛程式管理]。

此時,您可能會看到標示為 [安裝 XR 外掛程式管理 ] 按鈕的按鈕。 如果是,請繼續進行下列步驟。 如果您已安裝 XR 管理系統,您可以略過本節中的其餘步驟,並繼續下一節「選擇 'Windows Mixed Reality'」。

  1. 按一下 [安裝 XR 外掛程式管理 ] 按鈕。

  2. [ 偵測到內建 VR] 對話方塊隨即出現,並詢問您是否要移除內建的 VR 套件。 按一下 [確定] 。

    偵測到內建 VR 的訊息。

  3. [ 已啟用內建的 VR] 對話方塊隨即出現。 按一下 [確定] 。 這會停用內建 VR。

  4. [MRTK 專案設定器] 視窗隨即出現,並要求您啟用 XR 管線。 選取第二個選項 XR SDK/SR 管理

  5. 在 Configurator 的下一個頁面上,按一下 [ 顯示設定]。

3.選擇 [Windows Mixed Reality]

我們尚未準備好安裝 OpenXR,但下一組步驟可協助您清除任何只能在「內建 XR」路徑上使用和支援的 API。 (如果您使用 MRTK,大部分都會為您抽象化。)

  1. 在 [Unity 編輯器 專案設定 ] 視窗中,確定您位於 [XR 外掛程式管理 ] 頁面上。
  2. 執行下列其中一個動作:
    • 如果您要將目標設為HoloLens 2:
      請確定您位於 [通用 Windows 平臺] 索引標籤 (它是第二個索引標籤,並在 [外掛程式提供者] 底下) ,選取[Windows Mixed Reality]。
    • 如果您是以桌面 VR 為目標:
      請確定您位於 [桌面] 索引標籤 (它是第一個索引標籤,並顯示監視器) 的影像,然後在 [外掛程式提供者] 底下選取[Windows Mixed Reality]。
  3. MRTK 專案組態器視窗再次出現。 按一下 [ 下一步] 按鈕,然後按一下 [ 下一步 ]。 (您可能想要花一點時間閱讀這些頁面上的說明,再繼續進行。)
  4. 選取 [匯入 TMP Essentials]。
  5. 選取 [完成]。 這會關閉 Configurator。
  6. 關閉 [ 專案設定 ] 視窗,儲存您的專案,然後結束 Unity。

注意

當您在 Unity 2019 中使用 XR 外掛程式管理時,不支援 Azure Spatial Anchors (ASA) 。 如果您的專案有 ASA 程式碼,在安裝 Unity 2020 之後,您將無法進行測試。 否則,您應該能夠在此階段驗證您的應用程式。

4.升級至 Unity 2020.3 LTS

  1. 安裝 Unity 2020.3 的最新 LTS 修補程式版本
  2. 在 Unity 2020.3 中開啟 Unity 2019 專案。

您會看到一個對話方塊,詢問您是否要將專案升級至較新版本的 Unity。 按一下 [確認]。

如果您先前使用 AR Foundation 2.0,專案會自動移至 AR Foundation 4.0。

5.使用Mixed Reality功能工具來安裝更多套件

使用Mixed Reality功能工具匯入下列套件。

  1. 如果您使用 ASA,請開啟Azure Mixed Reality Services下拉式清單,然後選取最新版的Azure Spatial Anchors SDK Core適用于 Windows 的 Azure Spatial Anchors SDK
  2. 開啟 [平臺支援] 下拉式清單,然後選取最新版的 Mixed Reality OpenXR 外掛程式。
  3. 載入套件之後,會出現 [警告 ] 對話方塊,詢問您是否要重新開機 Unity 編輯器以啟用後端。 選取 [是]。
  4. Unity 重新開啟時, MRTK 專案組態器 隨即出現。 花點時間閱讀視窗中的說明,然後選取 [ 套用]。
  5. 此時會出現一個對話方塊,指出必須重新開機 Unity,輸入系統才會生效。 選取 [套用]。

6.設定 OpenXR 的 XR 外掛程式管理

Unity 再次重新開啟之後,您可以將 OpenXR 設定為執行時間:

  1. 在功能表列上,選取[編輯>專案設定]。

    查看左側資料行,並確定您位於[XR 外掛程式管理] 頁面,然後在 [通用 Windows 平臺] 索引標籤中, (索引標籤上有 Windows 標誌的影像) 。

  2. 在 [ 外掛程式提供者] 清單中,選取 [OpenXR]。

    外掛程式管理

  3. 在相同的區段中,選取[Microsoft HoloLens功能群組]。

  4. 請注意,[OpenXR] 旁邊現在有黃色警告三角形。 將游標停留在三角形上方,並讀取快顯中的訊息,然後選取三角形。

    OpenXR 警告訊息

  5. 在 [OpenXR Project Validation] \(OpenXR 專案驗證\) 視窗中,列出數個問題。 選取 [Fix All] \(全部修正\) 按鈕。

    專案驗證視窗

  6. 仍有一個問題,告知您至少必須新增一個互動設定檔。 若要這樣做,請按一下 [編輯]。這會帶您前往 [專案設定] 視窗中OpenXR外掛程式的設定。

    OpenXR 外掛程式設定

  7. 每次選擇不同的設定檔時,選取加號 (+) 按鈕三次:

    新增設定檔加號按鈕

    Eye Gaze Interaction Profile (眼球注視互動設定檔)

    Microsoft Hand Interaction Profile (Microsoft 手部互動設定檔)

    Microsoft Motion Controller Profile (Microsoft 動作控制器設定檔)

    互動設定檔

    如果 [Eye Gaze Interaction Profile] \(眼球注視互動設定檔\) 或任何其他設定檔在出現時,旁邊有一個黃色三角形,請選取三角形,然後在 [OpenXR Project Validation] \(OpenXR 專案驗證\) 視窗中,按一下 [Fix] \(修正\) 按鈕。

    眼球注視互動設定檔

  8. 在 [OpenXR 功能群組] 區段中,選取[Microsoft HoloLens],如果尚未選取 [手部追蹤] 和 [動作控制器模型],請選取 [手部追蹤] 和 [動作控制器模型]。

    OpenXR 功能群組

  9. 按一下 [Depth Submission Mode] \(深度提交模式\) 下拉式清單,然後選取 [Depth 16 Bit] \(深度 16 位元\)。

    Debpth 提交模式

  10. 關閉 [ 專案設定 ] 視窗,以及仍在開啟的任何其他視窗。

您的專案現在已完全移轉。

另請參閱