啟用 ARCore

在開始為您的應用程序開發增強現實體驗之前,您必須在您的 Unity 項目中啟用 ARCore 功能。為此,您需要:

  1. 安裝統一2019.4.3f1或更高版本
  2. 使用AR基金會合作項目
  3. 安裝 ARCore 擴展包
  4. 將您的應用程序配置為 AR 必需或 AR 可選
  5. 執行運行時檢查
  6. 將您的應用程序配置為 Depth Required 或 Depth Optional
  7. 確保您的應用符合 ARCore 的用戶隱私要求

將您的應用程序配置為 AR 必需或 AR 可選

:支持AR功能,應用程序可以通過兩種方式來配置AR RequiredAR Optional

一個AR Required的應用程序不能運行,無ARCORE。它需要一個ARCORE支持的設備有ARCORE,也被稱為Google Play Services for AR ,安裝就可以了。

  • 該谷歌Play商店使得AR Required只能在應用程式提供設備的支持ARCORE
  • 當用戶安裝一個AR Required的應用程序,谷歌的Play商店會自動安裝Google Play Services for AR 。然而,你的應用程序仍必須在案件執行額外的運行時檢查Google Play Services for AR必須更新或已被手動卸載。

一個AR Optional的應用程序使用ARCORE,以增加不同的功能。它具有可選的AR功能,這些功能僅激活在ARCORE支持有設備Google Play Services for AR安裝。

  • AR Optional的應用程序可以安裝並運行在不支持ARCORE設備上運行。
  • 當用戶安裝一個AR Optional的應用程序,谷歌的Play商店也不會自動安裝Google Play Services for AR與應用。
AR Required AR Optional
AR功能使用您的應用需要 ARCore 來實現基本功能。 ARCore 增強了您的應用程序的功能。您的應用可以在沒有 ARCore 支持的情況下運行。
Play 商店可見性您的應用僅在支持 ARCore 的設備上的 Play 商店中列出。您的應用程序如下正常上市程序
Google Play Services for AR安裝方法Play商店安裝Google Play Services for AR旁邊您的應用程序。應用程序使用ARSession.state下載和安裝ARCORE。
安卓minSdkVersion要求24 (的Android 7.0) 18 (的Android 4.3)
必須使用ARSession.state檢查ARCORE支持和安裝狀態

欲了解更多信息,請參閱我們的應用程序分佈概況

讓您的應用AR Required

安卓:

  1. 導航到Edit > Project Settings > XR Plug-in Management > ARCoreRequirement設置為Required默認。

  2. 點擊Edit > Project Settings > Player ,選擇了Android圖標的選項卡。下Other Settings > Identification指定Minimum API Level24或更高。

IOS:

  1. 導航到Edit > Project Settings > XR Plug-in Management > ARKitRequirement設置為Required默認。

  2. 點擊Edit > Project Settings > Player ,選擇了Android圖標的選項卡。下Other Settings > Identification指定Minimum API Level24或更高。

讓您的應用AR Optional

安卓:

  1. 導航到Edit > Project Settings > XR Plug-in Management > ARCore

  2. Requirement下拉菜單中,選擇Optional設置你的應用AR可選。

  3. 點擊Edit > Project Settings > Player ,選擇了Android圖標的選項卡。下Other Settings > Identification指定Minimum API Level18或更高。

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 Level18或更高。

執行運行時檢查

在運行時,AR 必需的應用程序將自動執行運行時檢查以確保目標設備:

  • 支持 ARCore
  • 已安裝Google Play Services for AR -如果沒有安裝(可能是因為它是由用戶刪除)或版本太舊,您的應用程序會提示用戶安裝或更新。
  • 擁有最新的 ARCore 設備配置文件數據 - 如果它已過期,您的應用將下載新數據。

設置ARSession.attemptUpdatefalse禁用這些默認檢查。您的應用仍應處理以下情況:

狀況行動
設備不支持 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安裝和支持狀態。

配置您的應用程序是Depth RequiredDepth Optional (僅限Android)

如果您的應用程序需要深度API的支持,無論是因為AR體驗的核心部分依賴於深度,或因為沒有為應用程序,使用深度的部分不溫和回落,您可以選擇限制在谷歌Play上的應用程序的分發商店支持深度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的用戶隱私要求

下一步