開始使用適用於 AR Foundation 的 ARCore 擴充功能

AR 擴充功能的 ARCore 擴充功能為 Unity 的 AR Foundation 套件新增功能，可讓您在應用程式中使用 Cloud Anchors、相機設定篩選器以及錄製與播放等功能。

需求條件

如要使用 AR Foundation 的 ARCore Extensions 進行開發，您需要：

Android

硬體

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

軟體

iOS

硬體

軟體

安裝 ARCore Extensions 套件

請按照下列步驟安裝 AR Foundation 的 ARCore Extensions。

隨附依附元件

  1. 請確認您已在開發環境中安裝及設定 AR Foundation。
  2. 開啟或建立新的 Unity 專案。
  3. 選取所需的目標建構平台：
    1. 從 File 選單中選取 Build Settings。
    2. 根據所需目標平台，選取 Android 或 iOS。
    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 擴充功能隨附其他依附元件。如果使用其他程式庫 (例如 Firebase Analytics) 需要不同版本的 Unity 外部依附元件管理員，則可能會發生未定義的行為，導致相依元件停止運作。

安裝不含套件依附元件的 ARCore 擴充功能，以避免程式庫版本衝突：

  1. 下載不含 EDM4U 版本的 ARCore 擴充功能和com.google.external-dependency-manager。
  2. 按照匯入含有 .tgz 檔案的 UPM 套件的操作說明，依下列順序安裝套件：
    1. com.google.external-dependency-manager、
    2. ARCore Extensions (不含 EDM4U)。

安裝 ARCore Extensions 時，Unity 也會自動安裝所需依附元件的適當版本：

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

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

設定 ARCore Extensions

  1. 在 Hierarchy 窗格中，以滑鼠右鍵按一下並加入下列遊戲物件 (如果尚未新增)：

    • XR > AR Session
    • XR > AR Session Origin
    • XR > ARCore Extensions

  2. 在 Hierarchy 窗格中，選取 ARCore Extensions 套件。

  3. 在 Inspector 窗格中，針對以下每個欄位按一下目標 按鈕，然後將每個欄位與對應的遊戲物件建立連結，如下所示：

    • Session：使用場景的 AR Session。
    • 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 資產。

      詳情請參閱 Unity (AR Foundation) Cloud Anchors 開發人員指南，適用於 Android 或 iOS 版本，以及設定相機指南。

上述所有 ARCore Extensions 欄位都已正確連結後，ARCore Extensions Inspector 窗格看起來會像這樣：

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

專案範例

隨附於 AR Foundation 的 ARCore Extensions 以搭配範例專案，讓您開始建構自己的專案。

  1. 在 Window 選單中，開啟 Package Manager 並選取 ARCore Extensions 套件。

  2. 在 Samples 下方，按一下範例專案的 Import，如下所述。

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

  • 地理空間 (僅限 Android) - 在全球範圍內建立 AR 體驗，並遠端附加內容，加到 Google 街景服務涵蓋的任何區域。詳情請參閱 Geospatial API 簡介。

  • 「PersistentCloudAnchors」 (Android 和 iOS)：利用實際位置的數位資訊層層互動，在現實生活中創造永久性的 AR 體驗，並設計可讓多位使用者透過不同裝置共用的體驗。詳情請參閱 Cloud Anchors 簡介。

後續步驟

透過 AR Foundation 的 ARCore Extensions，您現在可以在應用程式中使用 Cloud Anchors 和相機設定。