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

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

開始之前

閱讀本篇之前，需要確保您已完成：

• 有一個 有效的雲定位庫。
• 安裝 Unity（2021.3.30 LTS 或更高版本），建議使用 Unity 2022.3 或 Unity 6.3 的最新版本。
• 按 啟用 Mega 的方法導入 com.easyar.sense-**.tgz 和 com.easyar.mega-**.tgz 包。

示例使用方法（六步走）

下面將分六個步驟介紹如何配置並運行 EasyAR Mega 的核心示例 MegaBlock_Basic。

第一步：匯入範例

附註

如果透過 **All Samples** 匯入了全部範例，需要跳過此步驟。

1. 使用選單 Window > Package Manager 開啟 Package Manager，選中 EasyAR Sense Unity Plugin, 在右側的 Samples 中展開所有範例。
2. 選擇範例（如 MegaBlock_Basic），點選 Import。

附註

• 本教學不能直接用於頭顯設備，但在開發頭顯設備之前，需要使用手機開發了解流程。
• 如果您先前已經匯入過舊版 SDK 的範例，在升級 SDK 之後需先刪除舊範例再重新匯入。

第二步：填寫 License Key 並配置 Mega 雲定位服務

1. 選單欄選擇 EasyAR > Sense > Configuration；
   
2. 在開啟的 Project Settings 面板中貼上您的 License Key；
   

提示

EasyAR Sense License 可從 EasyAR 開發中心 建立。初次使用可依以下步驟建立：

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

附註

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

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

3. 將您的 Mega 雲定位庫的各項資訊配置到 Project Settings 面板中的 Mega Block 項；
   

提示

Mega 雲定位庫配置可從EasyAR開發中心獲取。

確保您的 API Key 具有 Mega Block 的權限，若無需進行變更或重新建立。

第三步：擺放 3D 內容

1. 在 Hierachy 面板空白處右鍵點擊，添加 Block 瀏覽工具（Unity 開發）；
   

2. 訪問 Mega 定位服務；

   1. 選中 EasyAR.Mega.BlockViewer (Dev) 節點，在 Inspector 面板中填寫您的 EasyAR 帳號資訊並登入；
      
   2. 點擊 Mega Cloud Service 右側按鈕；
      
   3. 選擇您所要使用的 Mega定位服務，點擊確定。
      

3. 加載 Block

   在選擇服務之後，當前庫中的 Block 列表會顯示在 MegaBlocks 節點下，並顯示在工具面板上。點擊加載選擇的Block：
   

   加載完成後，Block 會顯示在 Scene 視窗中。您可以在 Scene 視窗中操作，調整檢視的視角、位置。同時檢查下 Block 文件是否可用（比如 Block 座標系是否正常，是否存在分層，是否過於模糊、存在缺損而無法找到位置擺放 AR 資源等）。
   

4. 擺放 3D 內容

   此時，您可以參考 Block 擺放 3D 物體。
   

   附註

   • 3D 物體必需擺放在工具自動生成的 MegaBlocks > Block_* 節點之下，以確保在運行時虛擬內容的渲染位置是正確的。
   • 請不要修改 Block_* 節點的名字和 local transform，它由工具自動管理。

第四步：配置 MegaTracker

1. 配置 Block Root；

   展開 AR Session ，選擇 Mega Block Tracker 並設定 Block Root 為工具生成的 MegaBlocks 節點。
   

第五步：修改 player 配置

• Android
• iOS

依次在 Unity 選單 File > Build Settings > Player Settings，點擊安卓圖示，調出 Android 平台相應的設定。

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

  

  提示

  比如，如果您在建立 License Key 時填寫的 Package Name 是 com.mycompany.myproject，則必須填寫這裡 Package Name 為 com.mycompany.myproject，否則會執行失敗。

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

  

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

  

第六步：構建並運行

1. 添加當前場景至 File > Build Settings 或 Build Profiles > Scene List 中；
2. 切換至目標平台（如Android / iOS），檢查包名（Bundle ID）與 License Key 是否一致；
   
3. 點擊 Build And Run。
   

現場實拍的運行效果如下：

關於螢幕上的黃色文字

運行時，您可能會看到螢幕上顯示了兩處黃色文字。

1. 模擬運行的警告信息

   它位於螢幕下方：

   

   出現這個警告的原因是因為在默認配置下，應用可以不在現場運行。它對應用的運行效果有些微影響，如果您正好在現場使用，可以在打包前 修改 MegaTracker 配置。

2. 診斷信息

   它位於螢幕上方，用於了解 session 的運行狀態和問題，建議在開發和測試階段保持顯示：

   

   可以參考 場景中的診斷信息 來快速了解如何配置和使用這些診斷信息。

下一步：從入門到精通

恭喜！通過以上步驟，您已成功在 10 分鐘內 運行了 EasyAR Mega 的核心示例，親身體驗了空間定位與 AR 內容疊加的魅力。

現在，您已經掌握了基礎。如果您希望：

• 構建更穩定、更高效的 AR 應用
• 實現複雜的虛實遮擋、內容對齊等效果
• 在沒有裝置或無法前往現場時進行除錯

請參考以下深入指南，它們將幫助您解決開發過程中的實際問題。

開發進階

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

• 使用 Universal Render Pipeline (URP)
• Player 配置
• EasyAR 配置

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

• AR 驅動的 Unity 應用基礎

同時，建議閱讀以下內容來幫助您開發和調試：

• Unity 開發中的問題診斷和報告
• Unity AR 模擬運行

精細化控制 Mega 功能

下面的這些內容將幫助您更好地在您的應用中使用 Mega：

• 現場使用和模擬運行
• ARSession 最佳實踐
• 添加跟踪目標
• 建立與實景對齊的 3D 內容
• 環境遮擋 (Occlusion)
• 控制跟踪過程

下面的這些內容將幫助您無需到達現場即可驗證 Mega 功能：

• 使用 PC 相機進行快速驗證
• 使用 Session 驗證工具進行模擬運行

進階主題

以下內容更適合在具備一定 EasyAR 使用經驗後閱讀。

若您希望在頭顯上運行 EasyAR Mega，可參考以下內容：

• Unity 中的 EasyAR 头显支援
• 在 XR 頭顯或眼鏡上使用 EasyAR 範例

若您希望使用 AR Foundation，可從此處開始：

• EasyAR 對 Unity XR 框架的支援