開始使用 AR Foundation

Unity AR Foundation 是 可讓您撰寫擴增實境體驗的跨平台架構 一次製作適用於 Android 或 iOS 裝置的應用程式 並輸入變更內容此架構可透過 Unity 的 AR Foundation 套件使用。

ARCore 的選用項目 ARCore 擴充功能 - AR 基礎 套件可提供額外的功能，讓您使用如 Cloud Anchors、相機設定篩選器，以及錄製和播放 應用程式。

遷移或升級現有專案

  • 從 (已淘汰) Unity 的 ARCore SDK 遷移現有專案 Unity 的 AR Foundation 提供相關資訊，以及選用的 ARCore 擴充功能，請參閱 遷移指南。
  • 如要從舊版 AR Foundation 升級現有專案，請按照下列步驟操作： 請參閱 Unity 的 升級與遷移指南。

需求條件

視您的目標平台而定，AR Foundation 套件需要 包括：

Android

硬體

  • 支援 ARCore 的 Android 裝置或 模擬器
  • USB 傳輸線，可將裝置連接至開發機器

軟體

iOS

硬體

軟體

安裝 AR Foundation

請按照下列步驟安裝 AR Foundation Unity 套件。

  1. 開啟現有的 Unity 專案，或建立新的 3D 專案。

  2. 前往 Window > Package Manager。

  3. 選取「Packages」旁邊的「Unity Registry」。

  4. 在搜尋列中輸入「AR Foundation」。

  5. 按一下「Install」。

安裝及啟用平台專屬外掛程式套件

AR 基礎套件提供 Unity 開發人員使用的介面，但 並未實作任何 AR 功能在目標使用 AR Foundation 但您也必須安裝個別的套件，並啟用 以及各平台對應的外掛程式

Android

ARCore XR 外掛程式 套件可讓您建構適用於 Android 裝置的擴增實境應用程式。 如果您的應用程式是採用 Unity 專案，請按照下列步驟在 Unity 專案中安裝這個外掛程式 目標為 Android 裝置使用與 AR Foundation 套件相同的版本 避免任何相容性問題

  1. 在專案中前往 Window > Package Manager。

  2. 選取「Packages」旁邊的「Unity Registry」。

  3. 在搜尋列中輸入「ARCore XR 外掛程式」。

  4. 按一下「Install」。

  5. 前往 Edit > Project Settings。在 XR Plug-in Management 中開啟「Android」分頁，並啟用 ARCore。

iOS

ARKit XR 外掛程式 可讓您為 iOS 裝置打造擴增實境應用程式。 如果您的應用程式是採用 Unity 專案，請按照下列步驟在 Unity 專案中安裝這個外掛程式 可指定 iOS 裝置請使用與 AR Foundation 套件相同的版本， 避免任何相容性問題

  1. 在專案中前往 Window > Package Manager。

  2. 選取「Packages」旁邊的「Unity Registry」。

  3. 在搜尋列中輸入「ARKit XR plugin」。

  4. 按一下「Install」。

  5. 前往 Edit > Project Settings。在 XR Plug-in Management 中開啟「iOS」分頁，並啟用 ARKit。

設定 AR 工作階段，將 AR Foundation 元件新增至場景

場景需要 AR 工作階段才能啟用 AR 程序， 例如動作追蹤、環境理解和燈光估算 您需要下列遊戲物件才能支援 AR 工作階段：

AR 基礎 4.x

  • AR Session：控管 AR 體驗的生命週期。

  • AR Session Origin：將 AR 座標轉換為 Unity 世界座標

在新增遊戲物件之前，請先刪除預設的 Main Camera。這會由新的 AR Camera 取代。 AR Session Origin。

將新的 AR 遊戲物件加到場景中：在 Hierarchy 窗格，然後選取 XR。新增 新的AR Session和新的 AR Session Origin 遊戲物件

AR 基礎 5.x

  • AR Session：控管 AR 體驗的生命週期。

  • XR Origin：將 AR 座標轉換為 Unity 世界座標

在新增遊戲物件之前，請先刪除預設的 Main Camera。這會由新的 AR Camera 取代。 XR Origin。

將新的 AR 遊戲物件加到場景中：在 Hierarchy 窗格，然後選取 XR。新增 新的AR Session和新的 XR Origin 遊戲物件

調整 Player 設定

Android

  1. 前往 File > Build Settings 開啟 Build Settings 視窗。
  2. 在 Platform 下方，選擇 Android 並按一下 Switch Platform。
  3. 按一下「Player Settings」。

  4. 套用下列變更：

    Player Settings > … 值
    Other Settings > Rendering 取消勾選「Auto Graphics API」。
    如果 Vulkan 列在「Graphics APIs」底下，由於 ARCore 尚未支援 Vulkan，請將其移除。
    Other Settings > Package Name 請使用 Java 套件名稱格式建立不重複的應用程式 ID。
    例如，使用 com.example.helloAR。
    Other Settings > Minimum API Level 如果您要建構「必要 AR」應用程式，請指定 Android 7.0 'Nougat' (API Level 24) or higher。
    如果您要建構 AR 選用功能應用程式，請指定 Android API Level 19 or higher。
    Other Settings > Scripting Backend 如要在下一個步驟中啟用 ARM64 支援功能，請選取 IL2CPP 而不是 Mono。

    開發期間：

    • 使用 Mono + 32 位元 (ARMv7)
    • 安裝 FAT (32 位元與 64 位元) ARCore APK

    如何在 Play 商店上架：

    • 使用 IL2CPP
    • 同時啟用 32 位元 (ARMv7) 和 64 位元 (ARM64)，以符合 Play 商店的 64 位元版本規定
    • 選用 (適用於 2018.3 以上版本)：在 Build Settings 中啟用 Android App Bundles
    Other Settings > Target Architectures 符合 Google Play 的 64 位元版本規定： 啟用 ARM64 (64 位元 ARM)。 保持啟用 ARMv7 (32 位元 ARM)，以便支援 32 位元裝置。

iOS

  1. 前往 File > Build Settings 開啟 Build Settings 視窗。
  2. 在 Platform 下方，選擇 iOS 並按一下 Switch Platform。
  3. 按一下「Player Settings」。

  4. 進行下列設定：

    Player Settings > … 值
    Other Settings > Bundle Identifier 以反向 DNS 格式新增應用程式名稱。
    例如，使用 com.mycompany.myapp。
    Other Settings > Camera usage description 輸入說明，說明您使用 AR 的方式 (例如 ARKit)。
    Other Settings > Target minimum iOS version 11.0以上
    Other Settings > Architecture ARM64

後續步驟