啟用 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 Required | AR 選用 | |
|---|---|---|
| AR 功能用量 | 應用程式需要 ARCore 才能提供基本功能。 | ARCore 可擴增應用程式的功能，您的應用程式可在沒有 ARCore 支援的情況下執行。 |
| Play 商店顯示設定 | 應用程式只會顯示在支援 ARCore 的裝置上。 | 應用程式遵循一般上架程序。 |
| 「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 下方，指定
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」的應用程式，都必須在建立 ARCore 工作階段前使用 ARSession.Install() 協同程式，檢查是否已安裝相容版本的「Google Play 服務 - AR 適用」，並確保已下載所有必要的 ARCore 裝置設定檔資料。
在執行階段，AR Required 應用程式會自動執行執行階段檢查，確保目標裝置符合下列條件：
- 支援 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 工作階段。