在 AR Foundation 應用程式中啟用 AR (僅限 Android)

啟用 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 適用服務。
需要 ARAR (選用)
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

  1. 前往 Edit > Project Settings > XR Plug-in Management > ARCoreRequirement 預設為 Required

  2. 按一下 Edit > Project Settings > Player,選取有 Android 圖示的分頁。

  3. Other Settings > Identification 下方,指定 24 以上的 Minimum API Level

iOS

  1. 前往 Edit > Project Settings > XR Plug-in Management > ARKitRequirement 預設為 Required

  2. 按一下 Edit > Project Settings > Player,選取有 iOS 圖示的分頁。

  3. Other Settings > Configuration 下方,指定應用程式的 Target minimum iOS Version

讓應用程式選擇採用 AR 功能

Android

  1. 前往 Edit > Project Settings > XR Plug-in Management > ARCore

  2. Requirement 下拉式選單中選取 Optional,將應用程式設為選用 AR。

  3. 按一下 Edit > Project Settings > Player,選取有 Android 圖示的分頁。

  4. Other Settings > Identification 下方,指定 24 以上的 Minimum API Level

iOS

  1. 前往 Edit > Project Settings > XR Plug-in Management > ARKit

  2. Requirement 下拉式選單中選取 Optional,將應用程式設為 AR 選用功能。

  3. 按一下 Edit > Project Settings > Player,選取有 iOS 圖示的分頁。

  4. 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 的「使用者隱私權規定」。

後續步驟