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 後續可以更改，但次數有限。如果您有明確的應用包名，也可以填寫您自己的包名。

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

在編輯器中運行

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

確認系統相機正常

開啟 系統相機應用：

確認相機可以正常使用：

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

附註

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 的使用方法，可以從這裡開始：