啟用 ARCore

您必須先在 Unity 專案中啟用 ARCore 功能,才能開始開發應用程式的擴增實境體驗。步驟如下:

  1. 安裝 Unity 2019.4.3f1 以上版本
  2. 使用 AR Foundation 處理工作專案
  3. 安裝 ARCore 擴充功能套件
  4. 將應用程式設為 AR 必要或 AR 選用
  5. 執行執行階段檢查
  6. 將應用程式設為 [深度] 或 [深度 (選用)]
  7. 確認您的應用程式符合 ARCore 的使用者隱私權規定

將應用程式設為 AR 必要或 AR 選用

應用程式支援 AR 功能,有以下兩種設定:AR RequiredAR Optional

AR Required」應用程式必須搭配 ARCore 才能運作。必須使用支援 ARCore 的裝置,且已安裝 ARCore (也稱為 Google Play Services for AR)。

  • Google Play 商店只能在支援 ARCore 的裝置上使用 AR Required 應用程式。
  • 當使用者安裝 AR Required 應用程式時,Google Play 商店會自動安裝 Google Play Services for AR。不過,如果應用程式必須更新或手動解除安裝,Google Play Services for AR 仍然必須執行額外的執行階段檢查。

AR Optional 應用程式使用 ARCore 來擴增不同的功能。它具有選用的 AR 功能,這項功能只會在已安裝 Google Play Services for AR 的 ARCore 支援裝置上啟用。

  • AR Optional 應用程式可在不支援 ARCore 的裝置上安裝及執行。
  • 當使用者安裝 AR Optional 應用程式時,Google Play 商店「不會」自動安裝應用程式 Google Play Services for AR
AR RequiredAR Optional
AR 功能使用情形 應用程式需要 ARCore 才能提供基本功能。 ARCore 可強化應用程式的功能。您的應用程式可在沒有 ARCore 支援的情況下執行。
Play 商店顯示設定 您的應用程式只能在支援 ARCore 的裝置上的 Play 商店中上架。 您的應用程式必須遵守一般商家資訊程序
Google Play Services for AR 安裝方法 Play 商店會在安裝應用程式時一併安裝「Google Play Services for AR」。 您的應用程式會使用 ARSession.state 下載並安裝 ARCore。
Android minSdkVersion需求 24 (Android 7.0) 18 (Android 4.3)
必須使用 ARSession.state 檢查 ARCore 支援及安裝狀態

如需更多資訊,請參閱應用程式發布總覽

讓應用程式 AR Required

Android:

  1. 瀏覽至 Edit > Project Settings > XR Plug-in Management > ARCoreRequirement預設為 Required

  2. 按一下 [Edit > Project Settings > Player],選取有 Android 圖示的分頁。在 Other Settings > Identification 下,指定 Minimum API Level 或更高的 24

iOS:

  1. 瀏覽至 Edit > Project Settings > XR Plug-in Management > ARKitRequirement預設為 Required

  2. 按一下 [Edit > Project Settings > Player],選取有 Android 圖示的分頁。在 Other Settings > Identification 下,指定 Minimum API Level 或更高的 24

讓應用程式 AR Optional

Android:

  1. 瀏覽至 Edit > Project Settings > XR Plug-in Management > ARCore

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

  3. 按一下 [Edit > Project Settings > Player],選取有 Android 圖示的分頁。在 Other Settings > Identification 下,指定 Minimum API Level 或更高的 18

iOS:

  1. 瀏覽至 Edit > Project Settings > XR Plug-in Management > ARKit

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

  3. 按一下 [Edit > Project Settings > Player],選取有 Android 圖示的分頁。在 Other Settings > Identification 下,指定 Minimum API Level 或更高的 18

執行執行階段檢查

在執行階段期間,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,瞭解安裝和支援狀態。

將應用程式設為 Depth RequiredDepth Optional (僅限 Android 裝置)

如果您的應用程式需要 Depth API 支援,原因可能是 AR 體驗的核心功能須依賴深度,或者沒有使用深度的部分應用程式需要進行備用的復原作業,因此您可以選擇在 Google Play 商店中限制應用程式的發布範圍,以便支援 Depth API 的裝置

讓應用程式 Depth Required

瀏覽至 Edit > Project Settings > XR Plug-in Management > ARCore

Depth預設為 Required

讓應用程式 Depth Optional

  1. 瀏覽至 Edit > Project Settings > XR Plug-in Management > ARCore

  2. 在 [Depth] 下拉式選單中,選取 [Optional],將應用程式設為「深度」應用程式。

隱私權規定

確認您的應用程式符合 ARCore 的使用者隱私權規定

後續步驟