更新至 AR Foundation 5.x 版 (Beta 版)

Unity 的 AR Foundation 適用的 ARCore 擴充功能同時支援 AR 基礎的 4.x 版5.x 版。如要將現有 AR 專案從 AR 基礎 4.x 升級至 AR 基礎 5.x,請按照下列步驟操作:

  1. 僅限 Unity 2021.x 以下版本:
    部分 Unity 套件會繫結至特定 Unity 編輯器版本。您可能需要編輯 Unity 專案中的套件資訊清單,在特定 Unity 編輯器版本中更新至 AR Foundation 5.x。詳情請參閱「在 Unity 2021 中存取 AR 基礎 5.0」。

    確認 Packages/manifest.json 包含下列套件的版本:

    "dependencies": {
      -- other dependencies --
      "com.unity.xr.arcore": "5.0.5",
      "com.unity.xr.arfoundation": "5.0.5",
      "com.unity.xr.arkit": "5.0.5",
      -- other dependencies --
    }
    
  2. Unity 的 AR Foundation 適用的 ARCore 擴充功能使用ARCORE_USE_ARF_5 自訂指令碼符號來判斷版本相容性。如為 AR 基礎 5.x 相容性,請新增 ARCORE_USE_ARF_5 自訂指令碼符號

    1. 在「Edit」(編輯) >「Project Settings」(專案設定) >「Player」(播放器) >「Other Settings」(其他設定) 中,向下捲動至「Script Compilation」(指令碼編譯)
    2. 使用「+」+按鈕新增 +
    3. 選取「套用」。
  3. 由於 TrackedPoseDriver 依附元件的關係,AR 基礎 5.x 需要輸入系統套件。ARCore 擴充功能範例場景需要舊版輸入模組。

    如要同時支援輸入系統套件和舊版輸入管理員,請在「Project Settings」>「Player」>「Other Settings」中,將「Active Input Handling」設為「Both」

  4. 請按照 Unity 的 AR 基金會升級和遷移指南中的步驟進行。