Table of Contents

在 EasyAR 專案中啟用 AR Foundation

如果需要啟用 EasyAR 的 AR Foundation 支援，或使用 AR Foundation 的其它功能，需要正確安裝配置 AR Foundation。以下內容介紹如何完成這些操作。

開始之前

AR Foundation 版本相容性

EasyAR 支援 AR Foundation 5 或更新版本。

重要事項

AR Foundation 的支援是透過自訂相機實現的。

在自訂相機或頭顯上使用試用產品（個人版 license、試用版 XR license 或試用版 Mega 服務等）時，EasyAR Sense 每次啟動後會在 100 秒（Mega 用戶可經由 EasyAR 商務在審批後調整時間長度）後停止響應。使用付費版本的 EasyAR Sense 和付費的 EasyAR Mega 服務沒有這個限制。

安裝 AR Foundation

建議參考 AR Foundation 官方文件 來安裝 AR Foundation。閱讀前注意選擇對應的文件版本。

Unity 2022 及更新版本

如果工程中未安裝過 XR 相關外掛，需要在 Project Settings > XR Plug-in Management 中，點選 Install XR Plugin Management 按鈕來安裝 XR Plug-in Management 並等待安裝完成。

alt text

如果需要在 Android 平台使用 AR Foundation，在 Android 標籤下勾選 Google ARCore 並等待安裝完成。

alt text

如果需要在 iOS 平台使用 AR Foundation，在 iOS 標籤下勾選 Apple ARKit 並等待安裝完成。

alt text

如果需要在 visionOS 平台使用 AR Foundation，需要閱讀 Vision Pro 工程配置。

提示

建議保持 Initialize XR On Startup 處於勾選狀態，以確保 AR Foundation 能夠在預設時間點初始化。

安裝完成後，開啟 Package Manager 視窗，可以看到 AR Foundation 以及對應平台的外掛會出現在已安裝的套件清單中。注意這些套件的版本號應完全一致。

alt text

重要事項

在安裝和更新 AR Foundation 時，需要確保 Google ARCore XR Plugin 和 Apple ARKit XR Plugin 版本與 AR Foundation 版本完全一致。版本不相容可能會導致執行階段錯誤或功能異常。

Unity 2021

在 Unity 2021 版本中，需要手動編輯 Packages/manifest.json 檔案來指定版本，參考 官方文件。

比如，如果需要安裝 AR Foundation 5.2.0 版本並在 Android 和 iOS 平台使用，要確保 Packages/manifest.json 檔案中包含以下內容：

{
  "dependencies": {
    ...
    "com.unity.xr.arcore": "5.2.0",
    "com.unity.xr.arfoundation": "5.2.0",
    "com.unity.xr.arkit": "5.2.0",
    ...
  }
}

配置 XR Plug-in

在使用 EasyAR 時，通常 ARCore 的存在並不是必需的。因此應配置 ARCore 為可選，以避免在不支援 ARCore 的裝置上應用無法正常執行。

在 Project Settings > XR Plug-in Management > ARCore 中，將 Requirement 和 Depth 都設定為 Optional

alt text

注意

如果把 Requirement 設定為 Required，並在不支援 ARCore 的裝置上安裝了打包後的應用，裝置會錯誤地報告 ARCore 是可用的並以 ARCore 執行。這會造成一個假象，似乎這些裝置正在執行 ARCore 並且執行不正常（黑屏或其它異常情況），但這是錯誤的。

出現這個現象的原因是由於 Google Play 商店阻止在不受支援的裝置上安裝標記 ARCore 為必需的應用，所以這些應用總是假設它們正在受支援的裝置上執行。

正常配置下，這些裝置會在 session 組裝時判斷 ARCore 不受支援並使用 EasyAR 的功能。

如有需要，也可以參考以下官方文件來進一步配置 ARCore 和 ARKit。閱讀前注意選擇對應的文件版本。

配置 universal render pipeline

如果當前工程在使用 URP，需要配置 URP 資產。如未正確配置，AR Foundation 的攝影機背景圖可能無法正確渲染。

首先確保已經正確配置 EasyAR 的 URP Renderer Feature，參考 EasyAR 的 universal render pipeline 配置。

然後在Renderer Features 清單中新增 ARBackgroundRendererFeature

alt text

與 EasyAR 的 URP Renderer Feature 配置一樣，需要關注 Project Settings > Quality 中不同平台的配置，確保在所有需要使用 AR Foundation 的平台上都使用了正確配置了 ARBackgroundRendererFeature 的 URP 資產。

另外也可以參考 AR Foundation 官方的 URP 配置文件 進行配置，閱讀前注意選擇對應的文件版本。

附註

EasyAR 的 universal render pipeline 配置 仍是需要的，這樣才能確保在不支援 AR Foundation 的裝置上使用 EasyAR 介面的相關功能渲染仍能正常。

啟用 EasyAR AR Foundation 支援

在 Project Settings > EasyAR > Sense 中，確保 Unity XR > AR Foundation Support 選項被啟用。該選項是預設開啟的。

alt text

修改該選項會觸發指令碼重新編譯，需要等待指令碼編譯完成修改才會生效。如果 Unity 因為某種原因未正常觸發編譯，可以關閉 Unity，刪除 Library/ScriptAssemblies 資料夾來強制 Unity 重新編譯指令碼。

提示

如果 EasyAR 與工程中的 AR Foundation 不相容，且沒有同時使用 EasyAR 和 AR Foundation 的需求，可以關閉該選項。

後續步驟

相關主題