Table of Contents

使用示例快速入門 EasyAR Unity 開發

本教程介紹如何配置並運行 EasyAR Unity 示例，以快速入門 AR 開發。

準備空 Unity 工程

確保已安裝兼容的 Unity 版本（Unity 2021.3 或更高版本），建議使用 Unity 2022.3 或 Unity 6.3 的最新版本。

使用 3D (Built-in Render Pipeline) 模板創建空 Unity 工程：

附註

初次使用不建議使用 URP。

如果您在使用 Unity 6，需要手動下載並使用 3D (Built-In Render Pipeline) Template，默認安裝下它在模板列表靠後的位置。

重要事項

若要使用 URP，必須按照 Universal Render Pipeline (URP) 進行額外配置，否則相機畫面將無法顯示。

導入 EasyAR Sense Unity Plugin

  • 下載插件包
    • 下載最新版本的 EasyAR Sense Unity Plugin，其中包含示例（sample）。
    • 解壓下載的 zip 包之後可以看到 readme 和 .tgz 文件，.tgz 文件可以直接導入 Unity， 不能解壓。
    • 將 .tgz 文件存放到 Unity 項目 Packages 文件夾內。
  • 導入插件包
    • 從菜單欄依次點擊 Window 並選擇 Package Manager。
    • 在彈出的窗口中單擊左上角的 + 號， 選擇 Install Package from tarball ...。
    • 在彈出的對話框中選擇前述 .tgz 文件。

ImportUnityPlugin

附註

.tgz 文件在導入 Unity 後不能被刪除或移動到另一個位置，需要在導入前將這個文件放在合適的地方。通常建議放在 Unity 項目 Packages 文件夾內，方便版本管理。

導入示例

使用菜單 Window > Package Manager 打開 Package Manager，選中 EasyAR Sense Unity Plugin, 在右側選擇 **All Samples** 一次性導入所有示例。

ImportSample

注意

**All Samples** 和其他示例不可同時導入，否則會出現重複資產進而導致部分場景資源丟失。如不小心導入了重複的文件，需刪除後重新導入。

修改場景列表

打開 Build Settings （ 或 Build Profiles ），

將 Unity 工程中的示例場景添加到 Build Settings 或 Build Profiles 的 Scene List 中，並將示例啓動器的場景（AllSamplesLauncher）移動到所有場景中的第一個。

注意

注意不要這些添加頭顯的場景，否則可能會打包失敗：

  • Combination_BasedOn_AppleVisionPro.rst
  • Combination_BasedOn_Xreal.rst

填寫許可證（License Key）

從 Unity 菜單中選擇 EasyAR > Sense > Configuration 調出 EasyAR Sense 設置界面。

FillInKey

在 EasyAR Sense License 下的輸入框中填入 EasyAR Sense License。

FillInKey2

提示

EasyAR Sense License 可以從 EasyAR 開發中心（中文，英文） 創建。初次使用可以按以下步驟創建：

  • 創建 EasyAR Sense 4.x 個人版
  • 稀疏空間地圖選 是，名稱隨意填寫
  • 應用名稱隨意填寫，Bundle ID 和 Package Name 填寫 com.mycompany.myproject
  • 選擇剛創建的 License，進入之後點擊右側複製按鈕

copykey

附註

Bundle ID 和 Package Name 後續可以更改，但次數有限。如果您有明確的應用包名，也可以填寫您自己的包名。

個人版創建沒有個數限制，其它類型可以正式使用時按需創建。

編輯器中運行

在編輯器中運行需要您的電腦上連接一個攝像頭。

確認系統相機正常

打開 系統相機應用：

確認相機可以正常使用：

最後注意關閉相機應用，避免運行示例時發生衝突。

附註

EasyAR 僅使用系統提供的接口打開相機，需確保 系統相機應用 可以打開相機並正常顯示。

運行示例

以下內容以圖像跟蹤示例 ImageTracking_Targets 爲例，其他示例運行方式類似。

打開示例啓動器場景，並點擊 Unity 編輯器頂部的 Play 按鈕。

進入 ImageTracking_Targets 場景。

提示

也可以直接打開 ImageTracking_Targets 場景並執行。

將攝像頭對準以下識別圖：

namecard

下載地址：🔗 namecard

EasyAR 會識別跟蹤這張圖，併疊加虛擬物體。

附註

部分功能無法在編輯器中連接攝像頭運行，但可以在手機上運行。無法在編輯器中使用的示例在運行時會有啓動失敗的彈窗。

同時會有消息提示和錯誤log輸出。

手機上運行

在手機上運行需要進行打包，打包前需要修改 Player 配置。

修改 Player 配置

依次在 Unity 菜單 File > Build Settings > Player Settings，點擊安卓圖標，調出 Android 平臺 相應的設置。

switchtoandroid

  • 修改 Package Name 爲 License Key 頁面顯示的 Package Name

    androidPackageName

    提示

    比如，如果您在創建 License Key 時填寫的 Package Name 是 com.mycompany.myproject，則必須填寫這裏 Package Name 爲 com.mycompany.myproject，否則會運行失敗。

  • 修改 Minimum API Level 爲 API Level 21 或更高版本

    androidAPILevel

  • 修改 Scripting Backend 爲 IL2CPP，並在 Target Architecture 中勾選 ARM64

    androidarm64

打包應用

選擇 File > Build Settings，選擇目標平臺 (Android/iOS)，然後選擇 switch platform。

switchplatform

選擇 Build 或 Build And Run 編譯項目並在手機上安裝，運行時需允許相應權限。

buildandrun

運行示例

以下內容以圖像跟蹤示例 ImageTracking_Targets 爲例，其他示例運行方式類似。

運行後啓動的應是示例啓動器場景。

提示

如果打開後沒有進入示例啓動器場景，需要檢查是否正確設置了 Build Settings 或 Build Profiles 的場景列表，將 AllSamplesLauncher 移動到第一個。

進入 ImageTracking_Targets 場景。

將手機攝像頭對準以下識別圖：

namecard

下載地址：🔗 namecard

EasyAR 會識別跟蹤這張圖，併疊加虛擬物體。

後續步驟

您已經成功運行 Unity AR 示例，可能對示例所展示的 AR 場景是如何創建的感興趣。可以按順序閱讀以下入門指南：

關於示例啓動器可以參考詳細的使用說明：

如果您希望瞭解完整的工程配置，可以參考以下內容：

如果您希望進一步瞭解 EasyAR 的使用方法，可以從這裏開始：