在 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 功能,但只有支援 ARCore 且已安裝「Google Play 服務 - AR 適用」的裝置才能啟用。

  • AR 選用應用程式可以在不支援 ARCore 的裝置上安裝及執行。
  • 使用者安裝 AR 選用應用程式時,Google Play 商店不會自動在裝置上安裝 Google Play 服務 - AR 適用。
需要 ARAR 選用
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

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

後續步驟