只要啟用 AR,即可在新的或現有應用程式中使用擴增實境功能。
將應用程式設為 AR 必要或 AR 選用
為了節省個別裝置的儲存空間,所有 AR 功能都會儲存在名為「Google Play 服務 - AR 適用」的應用程式中,此應用程式會由 Play 商店另外更新。使用 AR 功能的 Android 應用程式會透過 ARCore SDK 與 Google Play 服務 - AR 通訊。支援 AR 功能的應用程式可透過兩種方式設定:「需要 AR 適用」和「選用 AR 適用」。這項標示可決定應用程式與「Google Play 服務 - AR 適用」應用程式的互動方式。
必要 AR 版本應用程式無法在沒有 ARCore 的情況下運作。必須使用支援 ARCore 的裝置,且裝置必須安裝 AR 適用的 Google Play 服務。
- Google Play 商店只會在支援 ARCore 的裝置上提供採用 AR 所需的應用程式。
- 使用者安裝 AR 所需應用程式後,Google Play 商店會自動在他們的裝置上安裝「Google Play 服務 - AR 適用」。不過,如果 AR 適用的 Google Play 服務版本過舊或已手動解除安裝,您的應用程式仍須執行其他執行階段檢查。
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.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() 協同程式
安裝「Google Play 服務 - AR 適用」 |
讓應用程式支援 AR
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,選取有 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 下方指定 Minimum API Level 為
24
以上。
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 裝置設定檔資料。如果資料過舊,您的應用程式就會是最新版本 系統會下載新資料
如要停用這些預設檢查功能,請將 ARSession.attemptUpdate
設為 false
。您的應用程式
仍應處理以下情況:
條件 | 動作 |
---|---|
裝置不支援 ARCore。 | 隱藏 AR 相關功能。 |
裝置支援 ARCore,但Google Play Services for AR 和/或 ARCore 裝置設定檔資料未安裝或版本過舊。 | 提示使用者安裝或更新 Google Play Services for AR 和/或
透過呼叫 ARCore 裝置設定檔資料
ARSession.Install() 。 |
裝置支援 ARCore 和 Google Play Services for AR 和 ARCore 裝置設定檔資料已安裝完成且為最新版本。 | 建立 ARCore Session ,並開始使用 ARCore。 |
您也可以前往 ARSession.state
查看安裝和支援狀態。
遵守使用者隱私權規定
如要在 Play 商店中發布應用程式,請確認您的應用程式符合 ARCore 的 使用者隱私權規定。
後續步驟
- 瞭解如何設定 ARCore 工作階段。