您必須先在 Unity 專案中啟用 ARCore 功能,才能開始開發應用程式的擴增實境體驗。步驟如下:
- 安裝 Unity 2019.4.3f1 以上版本
- 使用 AR Foundation 處理工作專案
- 安裝 ARCore 擴充功能套件
- 將應用程式設為 AR 必要或 AR 選用
- 執行執行階段檢查
- 將應用程式設為 [深度] 或 [深度 (選用)]
- 確認您的應用程式符合 ARCore 的使用者隱私權規定
將應用程式設為 AR 必要或 AR 選用
應用程式支援 AR 功能,有以下兩種設定:AR Required 或 AR Optional。
「AR Required」應用程式必須搭配 ARCore 才能運作。必須使用支援 ARCore 的裝置,且已安裝 ARCore (也稱為 Google Play Services for AR)。
- Google Play 商店只能在支援 ARCore 的裝置上使用 AR Required 應用程式。
- 當使用者安裝 AR Required 應用程式時,Google Play 商店會自動安裝 Google Play Services for AR。不過,如果應用程式必須更新或手動解除安裝,Google Play Services for AR 仍然必須執行額外的執行階段檢查。
AR Optional 應用程式使用 ARCore 來擴增不同的功能。它具有選用的 AR 功能,這項功能只會在已安裝 Google Play Services for AR 的 ARCore 支援裝置上啟用。
- AR Optional 應用程式可在不支援 ARCore 的裝置上安裝及執行。
- 當使用者安裝 AR Optional 應用程式時,Google Play 商店「不會」自動安裝應用程式 Google Play Services for AR。
AR Required | AR Optional | |
---|---|---|
AR 功能使用情形 | 應用程式需要 ARCore 才能提供基本功能。 | ARCore 可強化應用程式的功能。您的應用程式可在沒有 ARCore 支援的情況下執行。 |
Play 商店顯示設定 | 您的應用程式只能在支援 ARCore 的裝置上的 Play 商店中上架。 | 您的應用程式必須遵守一般商家資訊程序。 |
Google Play Services for AR 安裝方法 | Play 商店會在安裝應用程式時一併安裝「Google Play Services for AR」。 | 您的應用程式會使用 ARSession.state 下載並安裝 ARCore。 |
Android minSdkVersion 需求 |
24 (Android 7.0) |
18 (Android 4.3) |
必須使用 ARSession.state 檢查 ARCore 支援及安裝狀態 |
如需更多資訊,請參閱應用程式發布總覽。
讓應用程式 AR Required
Android:
瀏覽至 Edit > Project Settings > XR Plug-in Management > ARCore。Requirement預設為 Required。
按一下 [Edit > Project Settings > Player],選取有 Android 圖示的分頁。在 Other Settings > Identification 下,指定 Minimum API Level 或更高的
24
。
iOS:
瀏覽至 Edit > Project Settings > XR Plug-in Management > ARKit。Requirement預設為 Required。
按一下 [Edit > Project Settings > Player],選取有 Android 圖示的分頁。在 Other Settings > Identification 下,指定 Minimum API Level 或更高的
24
。
讓應用程式 AR Optional
Android:
瀏覽至 Edit > Project Settings > XR Plug-in Management > ARCore。
在 [Requirement] 下拉式選單中,選取 [Optional] 將應用程式設為 AR 選用。
按一下 [Edit > Project Settings > Player],選取有 Android 圖示的分頁。在 Other Settings > Identification 下,指定 Minimum API Level 或更高的
18
。
iOS:
瀏覽至 Edit > Project Settings > XR Plug-in Management > ARKit。
在 [Requirement] 下拉式選單中,選取 [Optional] 將應用程式設為 AR 選用。
按一下 [Edit > Project Settings > Player],選取有 Android 圖示的分頁。在 Other Settings > Identification 下,指定 Minimum API Level 或更高的
18
。
執行執行階段檢查
在執行階段期間,AR 需要的應用程式會自動執行執行階段檢查,以確保目標裝置:
- 支援 ARCore
- 已安裝 Google Play Services for AR:如果未安裝 (可能是使用者已遭移除) 或版本過舊,應用程式會提示使用者安裝或更新。
- 具備最新的 ARCore 裝置設定檔資料 - 如果版本過舊,應用程式將會下載新資料。
將 ARSession.attemptUpdate
設為 false
可停用這些預設檢查。您的應用程式仍應處理這些條件:
條件 | 動作 |
---|---|
裝置不支援 ARCore。 | 隱藏 AR 相關功能。 |
裝置支援 ARCore,但 Google Play Services for AR 和/或 ARCore 裝置設定檔資料並未安裝或過期。 | 呼叫 ARSession.Install() ,提示使用者安裝或更新 Google Play Services for AR 和/或 ARCore 裝置設定檔資料。 |
裝置支援 ARCore 和 Google Play Services for AR, 且已安裝 ARCore 裝置設定檔資料,而且皆為最新版本。 | 建立 ARCore Session 並開始使用 ARCore。 |
您也可以查看 ARSession.state
,瞭解安裝和支援狀態。
將應用程式設為 Depth Required 或 Depth Optional (僅限 Android 裝置)
如果您的應用程式需要 Depth API 支援,原因可能是 AR 體驗的核心功能須依賴深度,或者沒有使用深度的部分應用程式需要進行備用的復原作業,因此您可以選擇在 Google Play 商店中限制應用程式的發布範圍,以便支援 Depth API 的裝置。
讓應用程式 Depth Required
瀏覽至 Edit > Project Settings > XR Plug-in Management > ARCore。
Depth預設為 Required。
讓應用程式 Depth Optional
瀏覽至 Edit > Project Settings > XR Plug-in Management > ARCore。
在 [Depth] 下拉式選單中,選取 [Optional],將應用程式設為「深度」應用程式。
隱私權規定
確認您的應用程式符合 ARCore 的使用者隱私權規定。
後續步驟
- 設定 ARCore 工作階段,開始建構具備 AR 體驗的應用程式。