只要啟用 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 功能,但只有支援 ARCore 且已安裝「Google Play 服務 - AR 適用」的裝置才能啟用。
- AR 選用應用程式可以在不支援 ARCore 的裝置上安裝及執行。
- 使用者安裝 AR 選用應用程式時,Google Play 商店不會自動在裝置上安裝 Google Play 服務 - AR 適用。
需要 AR | AR 選用 | |
---|---|---|
AR 功能使用情形 | 您的應用程式需要有 ARCore 才能使用基本功能。 | ARCore 可強化應用程式的功能。您的應用程式可在不支援 ARCore 的情況下執行。 |
Play 商店瀏覽權限 | 您的應用程式只會在支援 ARCore 的裝置的 Play 商店中列出。 | 應用程式符合一般商店資訊程序。 |
Google Play 服務 - AR 安裝方式 | Play 商店會同時安裝您的應用程式適用的 Google Play 服務 - AR。 | 應用程式使用 ARSession.Install() 協同程式來下載並安裝 ARCore。 |
Android minSdkVersion 需求 |
Android 7.0 (API 級別 24) | Android 4.4 (API 級別 19) 版本,但如要執行任何 AR 功能,則至少需要 Android 7.0 (API 級別 24) |
必須使用 ARSession.state 檢查 ARCore 支援和安裝狀態
|
||
必須使用 ARSession.Install() 協同程式,安裝適用於 AR 的 Google Play 服務 |
要求應用程式使用 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 必要和 AR 選用應用程式前,都必須使用 ARSession.Install()
協同程式來建立 ARCore 工作階段,檢查是否已安裝相容的 Google Play 服務 AR 服務版本,並確保已下載所有必要的 ARCore 裝置設定檔資料。
在執行階段期間,AR 必要的應用程式將自動執行執行階段檢查,確保目標裝置:
- 支援 ARCore
- 已安裝 Google Play Services for AR:如果未安裝這個應用程式 (原因可能是使用者已移除),或版本過舊,應用程式會提示使用者安裝或更新。
- 擁有最新的 ARCore 裝置設定檔資料:如果 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 工作階段。