啟用 AR 即可在新的或現有應用程式中使用擴增實境功能。
將應用程式設為需要 AR 或 AR 選用
為了節省個別裝置的空間,所有 AR 功能都會儲存在名為「Google Play 服務 - AR 適用」的應用程式中,該應用程式會由 Play 商店分別更新。採用 AR 功能的 Android 應用程式會使用 ARCore SDK 與 Google Play 服務 - AR 通訊。你可以透過以下兩種方式設定支援 AR 功能的應用程式:需要擴增實境 (AR) 和選用 AR (選用)。這項標示可決定應用程式如何與 Google Play 服務 - AR 應用程式互動。
需要 AR 必要的應用程式無法在沒有 ARCore 的情況下運作。必須使用支援 ARCore 的裝置,並且安裝「Google Play 服務 - AR 適用」。
- Google Play 商店只會在支援 ARCore 的裝置上提供必要的 AR 應用程式。
- 當使用者安裝「需要 AR 規定」應用程式後,Google Play 商店就會自動在裝置上安裝「Google Play 服務 - AR 適用」服務。不過,假如 Google Play 服務 - AR 版本過舊或手動解除安裝,應用程式仍須執行額外的執行階段檢查。
AR 選用應用程式會利用 ARCore 強化現有功能。它具有選用的 AR 功能,只有在已安裝 Google Play 服務 - AR 支援的裝置上才支援 ARCore。
- 您可以在不支援 ARCore 的裝置上安裝及執行 AR 選用應用程式。
- 使用者安裝 AR 選用應用程式時,Google Play 商店不會自動在裝置上安裝 Google Play 服務 - AR 適用服務。
需要 AR | AR (選用) | |
---|---|---|
AR 功能使用情形 | 您的應用程式需要有 ARCore 才能使用基本功能。 | ARCore 可強化應用程式的功能。您的應用程式可以在不支援 ARCore 的情況下執行。 |
Play 商店顯示設定 | 您的應用程式只會在支援 ARCore 的裝置上的 Play 商店上架。 | 您的應用程式符合正常商店資訊程序。 |
「Google Play 服務 - AR 適用」安裝方法 | Play 商店會為您的應用程式一併安裝 Google Play 服務 - AR 適用服務。 | 您的應用程式會使用 ARSession.state 下載並安裝 ARCore。 |
Android minSdkVersion 需求條件 |
Android 7.0 (API 級別 24) | Android 4.4 (API 級別 19),不過「執行」任何 AR 功能需要 Android 7.0 以上版本 (API 級別 24) 以上的版本 |
必須使用 ARSession.state 查看 ARCore 的支援與安裝狀態 |
讓應用程式必須支援 AR
Android
前往 Edit > Project Settings > XR Plug-in Management > ARCore。Requirement 預設為 Required。
按一下 Edit > Project Settings > Player,選取有 Android 圖示的分頁。
在 Other Settings > Identification 下方,指定
24
以上的 Minimum API Level。
iOS
前往 Edit > Project Settings > XR Plug-in Management > ARKit。Requirement 預設為 Required。
按一下 Edit > Project Settings > Player,選取有 iOS 圖示的分頁。
在 Other Settings > Configuration 下方,指定應用程式的 Target minimum iOS Version。
讓應用程式選擇採用 AR 功能
Android
前往 Edit > Project Settings > XR Plug-in Management > ARCore。
在 Requirement 下拉式選單中選取 Optional,將應用程式設為選用 AR。
按一下 Edit > Project Settings > Player,選取有 Android 圖示的分頁。
在 Other Settings > Identification 下方,指定
24
以上的 Minimum API Level。
iOS
前往 Edit > Project Settings > XR Plug-in Management > ARKit。
在 Requirement 下拉式選單中選取 Optional,將應用程式設為 AR 選用功能。
按一下 Edit > Project Settings > Player,選取有 iOS 圖示的分頁。
在 Other Settings > Configuration 下方,指定應用程式的 Target minimum iOS Version。
執行執行階段檢查
檢查是否已安裝 Google Play 服務 - AR 服務
必要和 AR 選用應用程式都必須呼叫 ARSession.state
,才能建立 ARCore 工作階段,檢查是否已安裝相容版本的 Google Play 服務 - AR 服務,並確認已下載所有必要的 ARCore 裝置設定檔資料。
在執行階段,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
瞭解安裝和支援狀態。
遵守使用者隱私規定
如要在 Play 商店中發布應用程式,請確認您的應用程式符合 ARCore 的「使用者隱私權規定」。
後續步驟
- 瞭解如何設定 ARCore 工作階段。