選用 AR Foundation 套件適用的 ARCore 擴充功能,可為 Unity 的 AR Foundation 套件增添更多功能,讓您能夠在應用程式中使用 Cloud Anchor、相機設定篩選器以及錄製和播放等功能。
需求條件
如要使用 ARCore Extensions 進行開發,你需要:
Android
硬體
- 支援 ARCore 的 Android 裝置
- 用來將裝置連接至開發機器的 USB 傳輸線
軟體
- Unity 2019.4.3f1 以上版本 (支援 Android 建構支援)
- AR Foundation 4.1.5 以上版本 (自動安裝 ARCore Extensions for AR Foundation SDK 提供的 ARCore Extensions)
- ARCore XR 外掛程式 4.1.5 以上版本 (自動安裝 ARCore Extensions for AR Foundation SDK 的 ARCore Extensions)
iOS
硬體
- 與 ARKit 相容的支援 ARCore 的裝置
- 用來將裝置連接至開發機器的 USB 傳輸線
軟體
- Unity 2019.4.3f1 以上版本 (支援 iOS 建構支援)
- AR Foundation 4.1.5 以上版本 (自動安裝 ARCore Extensions for AR Foundation SDK 提供的 ARCore Extensions)
- ARKit XR 外掛程式 4.1.5 以上版本 (自動隨附適用於 AR Foundation SDK 的 ARCore Extensions 擴充功能)
- Xcode 11.0 以上版本
安裝 ARCore Extensions 套件
請按照下列步驟安裝 AR Foundation 專用的 ARCore Extensions 擴充功能。
隨附依附元件
- 確認您已在開發環境中安裝及設定 AR Foundation。
- 開啟或建立新的 Unity 專案。
- 選取所需的目標建構平台:
- 從 File 選單中選取 Build Settings。
- 根據所需目標平台選取 Android 或 iOS。
- 按一下「Switch Platform」。
匯入最新的 ARCore Extensions 套件:
- 前往 Window > Package Manager。
按一下 按鈕,然後從下拉式選單中選擇 Add package from git URL... 選項。
將下列網址貼到文字欄位中:
https://github.com/google-ar/arcore-unity-extensions.git
按一下「Add」。
不含 EDM4U
根據預設,ARCore 擴充功能會隨附其他依附元件。如果使用其他版本的 Unity 外部依附元件管理工具 (例如 Firebase Analytics),可能會發生未定義行為,導致依附元件停止運作。
安裝不含套件依附元件的 ARCore Extensions,以免發生程式庫版本衝突:
- 下載不含 EDM4U 版本的 ARCore Extensions 和
com.google.external-dependency-manager
, - 按照使用
.tgz
檔案匯入 UPM 套件的操作說明,按照下列順序安裝套件:com.google.external-dependency-manager
,- 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
在 Hierarchy 窗格中,按一下滑鼠右鍵並新增下列遊戲物件 (如果尚未新增):
- XR > AR Session
- XR > AR Session Origin
- XR > ARCore Extensions
在 Hierarchy 窗格中,選取 ARCore Extensions 套件。
在 Inspector 窗格中,針對下列每個欄位,按一下目標 按鈕,然後將每個欄位與對應的遊戲物件連接,如下所示:
- Session:使用場景的 AR Session。
- AR Session Origin:使用場景的 AR Session Origin。
- Camera Manager:使用場景的 AR Camera。
您也可以選擇為 Cloud Anchors 和相機設定篩選器,建立及連結下列資產。
在 Project > Assets 窗格中按一下滑鼠右鍵,選取 Create > XR > ARCore Extensions Config。
在 Project > Assets 窗格中按一下滑鼠右鍵,選取 Create > XR > Camera Config Filter。
在 Hierarchy 窗格中,選取 ARCore Extensions 套件。
在 Inspector 窗格的 ARCore Extensions Config 欄位中,按一下目標 按鈕,並連線至 ARCoreExtensionsConfig 素材資源。
在 Inspector 窗格的 Camera Config Filter 欄位中,按一下目標 按鈕,並連線至 ARCoreExtensionsCameraConfigFilter 素材資源。
詳情請參閱 Cloud Anchors 開發人員指南和設定相機指南。
如果使用 2020.3 以下版本:
- 依序前往「Project Settings」>「Player」>「Android」>「Publish Settings」>「Build」,選取「Custom Gradle Properties Template」。
上述所有 ARCore Extensions 欄位都正確連線後,ARCore Extensions Inspector 窗格看起來會像這樣:
AR Foundation 5.x
在 Hierarchy 窗格中,按一下滑鼠右鍵並新增下列遊戲物件 (如果尚未新增):
- XR > AR Session
- XR > XR Origin (Mobile AR)
- XR > ARCore Extensions
在 Hierarchy 窗格中,選取 ARCore Extensions 套件。
在 Inspector 窗格中,針對下列每個欄位,按一下目標 按鈕,然後將每個欄位與對應的遊戲物件連接,如下所示:
- Session:使用場景的 AR Session。
- XR Origin:使用場景的 XR Origin。
- Camera Manager:使用場景的 AR Camera。
您也可以選擇為 Cloud Anchors 和相機設定篩選器,建立及連結下列資產。
在 Project > Assets 窗格中按一下滑鼠右鍵,選取 Create > XR > ARCore Extensions Config。
在 Project > Assets 窗格中按一下滑鼠右鍵,選取 Create > XR > Camera Config Filter。
在 Hierarchy 窗格中,選取 ARCore Extensions 套件。
在 Inspector 窗格的 ARCore Extensions Config 欄位中,按一下目標 按鈕,並連線至 ARCoreExtensionsConfig 素材資源。
在 Inspector 窗格的 Camera Config Filter 欄位中,按一下目標 按鈕,並連線至 ARCoreExtensionsCameraConfigFilter 素材資源。
詳情請參閱 Cloud Anchors 開發人員指南和設定相機指南。
如果使用 2020.3 以下版本:
- 依序前往「Project Settings」>「Player」>「Android」>「Publish Settings」>「Build」,選取「Custom Gradle Properties Template」。
上述所有 ARCore Extensions 欄位都正確連線後,ARCore Extensions Inspector 窗格看起來會像這樣:
如要進一步瞭解如何設定屬性,請參閱 Unity 的編輯屬性指南。
專案範例
與 AR Foundation 的 ARCore Extensions 組合是範例專案,您可以開始建構自己的專案。
從 Window 選單中開啟 Package Manager,然後選取 ARCore Extensions 套件。
在 Samples 下方,按一下 Import 底下的範例專案。
下列範例專案是從 GitHub 存放區匯入:
地理空間 (僅限 Android) - 以全球規模打造 AR 體驗,並從遠端將內容附加到 Google 街景服務所涵蓋的任何區域。詳情請參閱地理空間 API 簡介。
PersistentCloudAnchors (Android 和 iOS) - 透過以實際位置固定而成的互動式數位資訊層,在現實世界中打造持續的 AR 體驗,以及可供多人在不同裝置中長期共用的設計體驗。詳情請參閱 Cloud Anchors 簡介。
後續步驟
有了 ARCore Extensions 的 ARCore 擴充功能,你可以在應用程式中使用 Cloud Anchor 和相機設定。