開始使用 AR Foundation 適用的 ARCore Extensions

選用 AR Foundation 套件適用的 ARCore 擴充功能,可為 Unity 的 AR Foundation 套件增添更多功能,讓您能夠在應用程式中使用 Cloud Anchor相機設定篩選器以及錄製和播放等功能。

需求條件

如要使用 ARCore Extensions 進行開發,你需要:

Android

硬體

  • 支援 ARCore 的 Android 裝置
  • 用來將裝置連接至開發機器的 USB 傳輸線

軟體

iOS

硬體

軟體

安裝 ARCore Extensions 套件

請按照下列步驟安裝 AR Foundation 專用的 ARCore Extensions 擴充功能。

隨附依附元件

  1. 確認您已在開發環境中安裝及設定 AR Foundation。
  2. 開啟或建立新的 Unity 專案。
  3. 選取所需的目標建構平台:
    1. File 選單中選取 Build Settings
    2. 根據所需目標平台選取 AndroidiOS
    3. 按一下「Switch Platform」。
  4. 匯入最新的 ARCore Extensions 套件:

    1. 前往 Window > Package Manager
    2. 按一下 按鈕,然後從下拉式選單中選擇 Add package from git URL... 選項。

    3. 將下列網址貼到文字欄位中:

      https://github.com/google-ar/arcore-unity-extensions.git
      
    4. 按一下「Add」。

不含 EDM4U

根據預設,ARCore 擴充功能會隨附其他依附元件。如果使用其他版本的 Unity 外部依附元件管理工具 (例如 Firebase Analytics),可能會發生未定義行為,導致依附元件停止運作。

安裝不含套件依附元件的 ARCore Extensions,以免發生程式庫版本衝突:

  1. 下載不含 EDM4U 版本的 ARCore Extensionscom.google.external-dependency-manager
  2. 按照使用 .tgz 檔案匯入 UPM 套件的操作說明,按照下列順序安裝套件:
    1. com.google.external-dependency-manager,
    2. ARCore 擴充功能 (不含 EDM4U)。

安裝 ARCore Extensions 時,Unity 也會自動安裝必要依附元件的適當版本:

  • AR Foundation
  • ARCore XR Plugin (指定 Android 時使用)
  • ARKit XR Plugin (指定 iOS 時使用)

這些依附元件可能不會顯示在 Package Manager > Package: In project 檢視畫面中。不過,您可以在 Packages 底下的 Project 視窗中查看套件

設定 ARCore Extensions

AR Foundation 4.x

  1. Hierarchy 窗格中,按一下滑鼠右鍵並新增下列遊戲物件 (如果尚未新增):

    • XR > AR Session
    • XR > AR Session Origin
    • XR > ARCore Extensions
  2. Hierarchy 窗格中,選取 ARCore Extensions 套件。

  3. Inspector 窗格中,針對下列每個欄位,按一下目標 按鈕,然後將每個欄位與對應的遊戲物件連接,如下所示:

    • Session:使用場景的 AR Session
    • AR Session Origin:使用場景的 AR Session Origin
    • Camera Manager:使用場景的 AR Camera
  4. 您也可以選擇為 Cloud Anchors 和相機設定篩選器,建立及連結下列資產。

    1. Project > Assets 窗格中按一下滑鼠右鍵,選取 Create > XR > ARCore Extensions Config

    2. Project > Assets 窗格中按一下滑鼠右鍵,選取 Create > XR > Camera Config Filter

    3. Hierarchy 窗格中,選取 ARCore Extensions 套件。

    4. Inspector 窗格的 ARCore Extensions Config 欄位中,按一下目標 按鈕,並連線至 ARCoreExtensionsConfig 素材資源。

    5. Inspector 窗格的 Camera Config Filter 欄位中,按一下目標 按鈕,並連線至 ARCoreExtensionsCameraConfigFilter 素材資源。

      詳情請參閱 Cloud Anchors 開發人員指南設定相機指南。

    6. 如果使用 2020.3 以下版本:

      • 依序前往「Project Settings」>「Player」>「Android」>「Publish Settings」>「Build」,選取「Custom Gradle Properties Template」

上述所有 ARCore Extensions 欄位都正確連線後,ARCore Extensions Inspector 窗格看起來會像這樣:

AR Foundation 5.x

  1. Hierarchy 窗格中,按一下滑鼠右鍵並新增下列遊戲物件 (如果尚未新增):

    • XR > AR Session
    • XR > XR Origin (Mobile AR)
    • XR > ARCore Extensions
  2. Hierarchy 窗格中,選取 ARCore Extensions 套件。

  3. Inspector 窗格中,針對下列每個欄位,按一下目標 按鈕,然後將每個欄位與對應的遊戲物件連接,如下所示:

    • Session:使用場景的 AR Session
    • XR Origin:使用場景的 XR Origin
    • Camera Manager:使用場景的 AR Camera
  4. 您也可以選擇為 Cloud Anchors 和相機設定篩選器,建立及連結下列資產。

    1. Project > Assets 窗格中按一下滑鼠右鍵,選取 Create > XR > ARCore Extensions Config

    2. Project > Assets 窗格中按一下滑鼠右鍵,選取 Create > XR > Camera Config Filter

    3. Hierarchy 窗格中,選取 ARCore Extensions 套件。

    4. Inspector 窗格的 ARCore Extensions Config 欄位中,按一下目標 按鈕,並連線至 ARCoreExtensionsConfig 素材資源。

    5. Inspector 窗格的 Camera Config Filter 欄位中,按一下目標 按鈕,並連線至 ARCoreExtensionsCameraConfigFilter 素材資源。

      詳情請參閱 Cloud Anchors 開發人員指南設定相機指南。

    6. 如果使用 2020.3 以下版本:

      • 依序前往「Project Settings」>「Player」>「Android」>「Publish Settings」>「Build」,選取「Custom Gradle Properties Template」

上述所有 ARCore Extensions 欄位都正確連線後,ARCore Extensions Inspector 窗格看起來會像這樣:

如要進一步瞭解如何設定屬性,請參閱 Unity 的編輯屬性指南。

專案範例

與 AR Foundation 的 ARCore Extensions 組合是範例專案,您可以開始建構自己的專案。

  1. Window 選單中開啟 Package Manager,然後選取 ARCore Extensions 套件。

  2. Samples 下方,按一下 Import 底下的範例專案。

下列範例專案是從 GitHub 存放區匯入:

  • 地理空間 (僅限 Android) - 以全球規模打造 AR 體驗,並從遠端將內容附加到 Google 街景服務所涵蓋的任何區域。詳情請參閱地理空間 API 簡介

  • PersistentCloudAnchors (Android 和 iOS) - 透過以實際位置固定而成的互動式數位資訊層,在現實世界中打造持續的 AR 體驗,以及可供多人在不同裝置中長期共用的設計體驗。詳情請參閱 Cloud Anchors 簡介

後續步驟

有了 ARCore Extensions 的 ARCore 擴充功能,你可以在應用程式中使用 Cloud Anchor相機設定