為 Android 啟用 ARCore

本頁面介紹瞭如何在面向 Android 設備的 Unity 項目中啟用 ARCore 功能。為此,您需要:

  1. 為 Unity 導入 ARCore SDK
  2. 將您的應用程序配置為 AR 必需或 AR 可選
  3. 確保您的應用符合ARCORE的用戶隱私要求

面向 AR 的 Google Play 服務

ARCORE的SDK使得可在AR功能ARCORE支持的設備谷歌播放服務AR安裝(ARCORE)。

適用於 AR 的 Google Play 服務會在絕大多數受支持的設備上自動安裝並保持最新狀態。

在開始 AR 會話之前,應用程序必須:

  1. 檢查ARCORE支持,通過調用CheckApkAvailability
  2. 檢查谷歌播放服務AR的安裝和更新,並且需要ARCORE設備配置文件數據已被下載,通過調用Session.RequestApkInstallation(bool userRequested)

為 Unity 導入 ARCore SDK

  1. 打開團結,創建一個新的3D項目。

  2. 安裝特定於版本的軟件包。

    團結 2020

    選擇Window>包管理器,並安裝以下軟件包:

    • 多人HLAPI(由雲錨樣品所需)
    • XR插件管理(由即時預覽,其使用所需的TrackedPoseDriver

    團結 2019

    選擇Window>包管理器,並安裝以下軟件包:

    • 多人HLAPI(由雲錨樣品所需)
    • XR舊式輸入助手(由即時預覽,其使用所需的TrackedPoseDriver

    團結 2018

    不需要額外的包。繼續下一步。

    團結 2017

    不需要額外的包。繼續下一步。

  3. 為 Unity 導入 ARCore SDK:

    1. 選擇資產>導入包>自定義套餐

    2. 選擇arcore-unity-sdk-1.25.0.unitypackage您下載。

    3. 導入包對話框中,確保所有的包選項被選中,然後單擊導入

在Unity的項目窗口中,你應該看到在SDK文件和HelloAR示例應用程序既Assets/GoogleARCore/Examples/HelloAR/

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

AR必AR可選:支持AR功能,應用程序可以通過兩種方式進行配置。如果您需要幫助決定哪一種選擇,看在谷歌Play商店發布應用AR

需要 AR

要使用,一個AR必需的應用程序需要ARCORE支持設備谷歌播放服務AR安裝就可以了。

  • 該谷歌Play商店使得AR只需要上的哪些應用提供設備的支持ARCORE

  • 當用戶安裝一個AR應用程序所需的谷歌Play商店會自動安裝谷歌播放服務AR 。然而,你的應用程序仍必須執行額外的運行時檢查的情況下,谷歌播放服務AR必須更新或已被手動卸載,或ARCORE設備配置文件的數據不是最新的。

欲了解更多信息,請參閱發布AR應用在谷歌Play商店

要使應用程序成為 AR 必需的,請按照以下步驟操作。

團結 2020

  1. 打開編輯>項目設置。選擇谷歌ARCORE並驗證所需的Arcore檢查。

  2. 通過單擊編輯>項目設置>播放器,並選擇與Android圖標的選項卡設置適當的最低API級別。下的其他設置>標識選擇一個最小API級別24或更高。

團結 2019

  1. 打開編輯>項目設置。選擇谷歌ARCORE並驗證所需的Arcore檢查。

  2. 通過單擊編輯>項目設置>播放器,並選擇與Android圖標的選項卡設置適當的最低API級別。下的其他設置>標識選擇一個最小API級別24或更高。

團結 2018

  1. 打開編輯>項目設置。選擇谷歌ARCORE並驗證所需的Arcore檢查。

  2. 通過單擊編輯>項目設置>播放器,並選擇與Android圖標的選項卡設置適當的最低API級別。下的其他設置>標識選擇一個最小API級別24或更高。

團結 2017

  1. 打開編輯>項目設置>谷歌ARCORE,然後驗證所需的Arcore檢查。

  2. 通過單擊編輯>項目設置>播放器,並選擇與Android圖標的選項卡設置適當的最低API級別。下的其他設置>標識選擇一個最小API級別24或更高。

您的應用將自動執行運行時檢查,以確保設備支持 ARCore 並安裝了適用於 AR 的 Google Play 服務,並且 ARCore 設備配置文件數據是最新的。如果 Google Play Services for AR 沒有安裝(可能是因為被用戶刪除了)或者版本太舊,你的應用會提示用戶安裝或更新。如果 ARCore 設備配置文件數據不是最新的,您的應用程序將下載並更新它。如果安裝或更新失敗(可能由於網絡故障), Session.Status會返回一個錯誤,你的應用程序應該處理錯誤並退出。

AR 可選

一個AR可選的應用程序具有可選的AR功能,這些功能僅激活在具有設備的AR谷歌播放服務安裝。

  • AR 可選應用程序可以在不支持 ARCore 的設備上安裝和運行。

  • 當用戶安裝一個AR可選的應用程序,谷歌的Play商店也不會自動安裝谷歌播放服務AR與應用。

要將應用程序設為 AR 可選,請按照以下步驟操作。

團結 2020

  1. 打開編輯>項目設置。選擇谷歌ARCORE並取消ARCORE必需

  2. 通過單擊編輯>項目設置>播放器,並選擇與Android圖標的選項卡設置適當的最低API級別。下的其他設置>標識選擇一個最小API級別18或更高。

團結 2019

  1. 打開編輯>項目設置。選擇谷歌ARCORE並取消ARCORE必需

  2. 通過單擊編輯>項目設置>播放器,並選擇與Android圖標的選項卡設置適當的最低API級別。下的其他設置>標識選擇一個最小API級別18或更高。

團結 2018

  1. 打開編輯>項目設置。選擇谷歌ARCORE並取消ARCORE必需

  2. 通過單擊編輯>項目設置>播放器,並選擇與Android圖標的選項卡設置適當的最低API級別。下的其他設置>標識選擇一個最小API級別18或更高。

團結 2017

  1. 打開編輯>項目設置>谷歌ARCORE並取消ARCORE必需

  2. 通過單擊編輯>項目設置>播放器,並選擇與Android圖標的選項卡設置適當的最低API級別。下的其他設置>標識選擇一個最小API級別18或更高。

執行運行時檢查

當啟動時,您的應用程序必須調用Session.CheckApkAvailability()來檢查設備是否支持ARCORE,如果是這樣,谷歌是否播放服務AR和ARCORE設備配置文件數據安裝並及時更新。

您的應用應處理以下情況:

狀況行動
設備不支持 ARCore。隱藏與 AR 相關的功能。
設備支持 ARCore,但用於 AR 和/或 ARCore 設備配置文件數據的 Google Play 服務未安裝或已過期。提示用戶安裝或致電更新谷歌播放服務AR和/或ARCORE設備配置文件數據Session.RequestApkInstallation()
設備支持 ARCore 和 Google Play 服務,AR 和 ARCore 設備配置文件數據已安裝並且是最新的。創建一個ARCORE Session使用ARCORE開始。

用戶隱私要求

確保您的應用符合ARCORE的用戶隱私要求

下一步

讀取在示例應用程序和代碼ARCORE供統一的API參考