在 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 的裝置，且裝置必須安裝 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 適用。
支援 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() 協同程式 安裝「Google Play 服務 - AR 適用」

讓應用程式支援 AR

Android

  1. 前往 Edit > Project Settings > XR Plug-in Management > ARCore。Requirement 目前預設為 Required。

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

  3. 在 Other Settings > Identification 下方指定 Minimum API Level 為 24 以上。

iOS

  1. 前往 Edit > Project Settings > XR Plug-in Management > ARKit。Requirement 目前預設為 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 下方指定 Minimum API Level 為 24 以上。

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 裝置設定檔資料。如果資料過舊，您的應用程式就會是最新版本 系統會下載新資料

如要停用這些預設檢查功能，請將 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 的 使用者隱私權規定。

後續步驟