Table of Contents

EasyAR Sense Unity Plugin 發行說明

我們很高興地宣佈 EasyAR Sense Unity Plugin 4000 發佈。此版本標誌着 EasyAR 具備了完善的 API 和與時俱進的設備支持，同時新版本發佈也將比以往更加頻繁。

下載 EasyAR Sense Unity Plugin 4000 以享受這些新功能和改進。

歷史版本

版本 4003.1.1

發佈日期：2026-09-07

  • 🚀 新增 EasyAR Sense Unity Plugin Meta XR 擴展，支持 Meta Quest 3/3S
  • 🐛 修復當輸入擴展的 DeviceOriginType 爲 OriginType.External 時無法使用的問題
  • 🔧 AR session 在 Mega 雲服務配置爲禁用時不再啓動失敗

版本 4003.1.0

發佈日期：2026-08-20

  • ✨ 新增 Mega Go 支持
  • ✨ 新增在頭顯上 ARSession.InputFrameUpdate 接口支持，用於在頭顯上運行時獲取非實時相機數據
  • 🐛 修復 session 啓動時播放 EIF 可能導致 Mega 定位失敗的問題
  • ⬆️ 更新 EasyAR Sense 到 4.10.0
  • ⬆️ 更新 EasyAR Sense Unity Plugin PICO 擴展到 4000.1.0
    • ✨ 新增支持 PICO 4 Ultra 用戶設備，PICO Space Pro，兼容未來 PICO 新設備
    • 💥 替換 PICO 企業設備接口爲用戶設備接口，企業設備上運行不再需要 PICO 進行企業授權

版本 4003.0.0

發佈日期：2026-07-01

  • 🚀 全新的 Mega 開發流程
    • ✨ Mega 功能接口和開發流程更加貼近圖像跟蹤等傳統 AR 功能
    • ✨ 添加 MegaBlockController 組件，替代原先由 Mega Studio 生成的節點組
    • ✨ session 驗證工具支持更多實用 Mega 控制選項
    • ✨ 使用全局配置開關控制 Mega 功能的啓用
    • 💥 運行時不再強制依賴 com.easyar.mega，com.easyar.mega 將只提供編輯器及 ema 功能
    • 🔥 移除多 block 配置選項和 block 根節點，block 各自獨立
    • 🔥 移除 MegaTrackerFrameFilter 編輯器測試區域，該功能由 session 驗證工具完全替代
  • 🐛 修復 Unity 6 以上版本使用 sample 時，場景偏暗的問題
  • 🐛 修復 Unity 6.4 URP 環境下部分腳本編譯錯誤
  • 🐛 修復 MotionTrackerFrameFilter 編輯器高級選項修改無法保存
  • ⬆️ 更新 EasyAR Mega 支持包到 2.13.0
    • 🚚 拆分原 com.easyar.mega 爲兩個包，分別爲 com.easyar.mega（Mega 支持包） 和 com.easyar.mega.studio（Mega Studio），Mega Studio 不再支持 Unity 開發使用
    • 🚚 部分接口從 EasyAR.Mega.Scene 命名空間移到 EasyAR.Mega 命名空間
    • ✨ 支持 Mega 國際服務
    • ✨ 支持編輯器 play 模式使用全景圖預覽功能
    • ✨ 支持在 prefab 視圖查看 block 數據
    • ✨ 允許 block 在編輯器中自由旋轉
    • ✨ 加載失敗時強制顯示 mesh 邊界 gizmo
    • 🔥 移除對建圖服務 9.3 及之前版本生成的 block 數據的支持
    • 🔥 移除對定位服務 2.0 及之前版本的支持
    • 🔥 移除對 ema 0.3-0.4 的支持
    • 🔥 移除對場景中標註節點的支持
  • ⬆️ 更新 EasyAR Sense Unity Plugin Extensions 到 4000.0.1
    • 🔧 調整 sample 場景中的 Mega 組件

版本 4002.0.0

發佈日期：2026-05-18

  • 🐛 修復 Unity 6.4.4 Android 打包失敗的問題。
  • 🔧 調整部分示例代碼。
  • ⬆️ 更新 EasyAR Sense 到 4.9.0

版本 4001.0.0

發佈日期：2026-03-10

  • 🐛 修復原生到 Unity 的 pose 轉換中存在的數值問題。該問題會導致在某些設備上使用 Mega 時容易出現短時間的 pose 跳變，從而導致內容快速閃爍或抖動。該問題的修復可能也會解決其它類似潛在問題。
  • 🔧 調整 MegaTrackerFrameFilter 部分接口以適配 EasyAR Sense 接口變化
  • ⬆️ 更新 EasyAR Sense 到 4.8.0

版本 4000.0.1

發佈日期：2025-11-14

  • 🐛 修復：解決了在啓用 minify 打包的 Android 構建中，因缺少靜態方法（ loadLibraries 、 setupActivity ）而可能觸發的運行時 AndroidJavaException 異常，該錯誤會導致 EasyAR 無法運行。

版本 4000.0.0

發佈日期：2025-10-20

從這個版本開始，EasyAR Sense Unity Plugin 將遵循 Unity 所要求的 包版本控制（使用 Semantic Versioning） ，因此版本號將與 EasyAR Sense 相異，發佈頻率也可能不同。該版本插件內包含 EasyAR Sense 4.7.0 正式版。

EasyAR Sense Unity Plugin 4000.0.0 迎來了大幅改變，主要集中在這幾方面：

  1. Unity 及 AR Foundation 兼容性變化

    從這個版本開始，EasyAR Sense Unity Plugin 將只支持 Unity 2021.3 及更新版本，Unity 6 支持也已經完善。同時，AR Foundation 支持已經合併到插件包內，這個版本將只支持 AR Foundation 5 及更新版本，其使用經過大量簡化。如果場景中添加了 AR Foundation 的組件，無論運行之後 AR Foundation 是否最終使用，場景配置和腳本代碼都可以不變。

  2. 與時俱進的頭顯支持，新增支持多款 OST/VST 頭顯

    經過與行業內多家企業多年的打磨，EasyAR 對頭顯的支持已經標準化。現在您可以通過 EasyAR Sense Unity Plugin 擴展實現第三方頭顯設備的支持（可能需要頭顯廠商提供部分數據接口）。這個版本內置了 Apple Vision Pro 以及 XREAL Air2 Ultra 的支持，同時通過 EasyAR Sense Unity Plugin 擴展包支持 Pico 4 Ultra Enterprise 及 Rokid AR Studio。 同時您也可以從 EasyAR 的一些合作伙伴那裏獲取其它設備的支持擴展包（比如 Xrany 元霓）。

  3. 完善 Unity 組件接口，大幅優化 ARSession 工作流

    這個版本是第一個通過 Unity 組件完整封裝 EasyAR Sense 功能的版本。ARSession 經過了大量優化和重寫，現在您可以輕鬆實現設備或功能的支持判斷，根據具體情況啓動或停止 ARSession 以實現運行時切換 ARSession 或不同 AR 功能。同時，您也可以使用 ARSessionFactory 在運行時創建 ARSession 及相關組件。這個版本還添加了慣性導航和 3DoF 相機功能，這些功能主要爲 EasyAR Mega 所設計，但也可以單獨使用。

  4. 新增多個開發及診斷工具

    這個版本增加了提供了全新的 EIF 錄製和播放功能，雖然 EIF 錄製和播放在過去的版本中也能使用，但使用 EIF 從未如此簡單。您現在可以在 Unity 編輯器中使用時診斷工具 Session Validaion Tool 直接播放 eif 並驅動您的場景，無論是圖像跟蹤、空間地圖還是 EasyAR Mega，都可以在電腦上還原設備上的運行效果。現在您可以使用運行時診斷面板 EasyAR Diagnostics Panel 在 app 中輕鬆開啓 eif 錄製功能，或是隨時開關 ARSession 及其組件的關鍵狀態信息顯示。同時，這個版本的 sample 已經全部重寫，運行 sample 就可以直接看到 ARSession 狀態以及錄製 eif 的按鈕以方便使用。

  5. EasyAR Mega 工具全面公開

    這個版本集成發佈了 Mega Studio 2.12。今後插件的更新將更加頻繁，Unity 側 Mega 工具將逐步合併進插件內部並與插件常規更新合併發佈。除了過去預發佈版本中的更新之外，這個版本會默認開啓慣導支持，進一步大幅拓展 EasyAR Mega 的設備支持。這個版本還包含對最新版本 EasyAR Mega Landmark 服務的支持。使用 EasyAR Mega 可以通過 EasyAR 網站頁面 進行申請。

詳細更新內容如下：

Unity 及 AR Foundation 兼容性變化：

  • 🔧 Unity：支持 Unity 2021.3 及更新版本（包括 Unity 2022.x/Unity 6.x）
    • 🔥 移除對 Unity 2019/Unity 2020 的支持
    • 🔥 移除用於 Unity 2019 的 gradle 版本檢測
    • 🔥 移除用於 Unity 2019 的選項 DisableARCoreAREngine
  • ✨ Unity 6：全面支持 Unity 6
    • ✨ 支持 URP 17+ 及 Render Graph
    • 🐛 已修復：Unity 6 上 ClassLoader 行爲變化導致 ARCore 失效
    • 🐛 已修復：Render Scale 非 1 時相機渲染失效
    • 🐛 Unity 6 自身 BUG：在 iOS/Mac 設備上可以觀察到視覺故障和僞影。該問題僅發生在需要獲取相機紋理的情況，我們添加了部分緩解措施但無法完全消除。已反饋至 Unity，見 Unity Issue UUM-87787 。Unity 6.2 以上可以通過設置 Universal Render Pipeline Asset 中的 Render Scale 爲 0.96-1.05 以外的數值來規避這個問題。
    • 🐛 Unity 6 自身 BUG：Windows DX11 上的渲染效果不正常。我們在 Unity 6.0-6.1 中已添加緩解措施。實測 Unity 6.2 已修復該問題。
  • ✨ AR Foundation：支持 AR Foundation 5 及更新版本，大幅簡化使用
    • ✨ AR Foundation 支持已經合併到插件包內，不再需要單獨導入包（特殊需要可以通過配置選項關閉）
    • ✨ 支持複用 Unity.XR.CoreUtils.XROrigin 作爲 ARSession 的原點，支持複用 XROrigin 的 Camera
    • ✨ 添加 Unity XR Auto Switch 配置選項，默認處理 Unity XR（包含 AR Foundation）物體的切換
    • ✨ 通過 EasyAR 菜單創建的 ARSession 自動包含並默認開啓 AR Foundation 支持
    • ✨ 絕大部分 sample 都已添加 AR Foundation 支持（AR Foundation 本身需要手動導入並正確配置）
    • 🔧 ARCore 及 ARKit 可單獨控制，且可控制 EasyAR 內置的 ARCore/ARKit 與 AR Foundation 的 ARCore/ARKit 的優先順序
    • 🔥 移除對 AR Foundation 4 的支持
    • 🔥 移除對 ARSessionOrigin 的支持，僅支持 XROrigin
    • 🔥 移除代理執行 AR Foundation 的 ARCore 安裝流程
  • ✨ 全面兼容 Input System Package

與時俱進的頭顯支持，新增支持多款 OST/VST 頭顯：

  • 🚀 頭戴顯示設備接口已穩定，支持第三方接入
    • ✨ 支持第三方設備接入（需要頭顯廠商提供特定數據接口）
    • ✨ 支持 XROrigin 及 XR Interaction Toolkit
    • ✨ 簡化並統一所有頭顯樣例，零代碼，並支持功能切換
    • ✨ 支持魚眼相機輸入
    • ✨ 支持自定義相機輸入 3DOF 數據
    • ✨ 添加菜單功能：Extensions，整合所有擴展菜單項
    • 🐛 修復部分頭顯運行 DenseSpatialMap 時出現渲染異常
    • 🔥 移除 ActionOne 和 BT350 等古早眼鏡 sample
  • ✨ 內建支持 Apple Vision Pro
    • ✨ 支持 Metal、RealityKit 及 Hybrid 模式
    • ✨ 支持 visionOS >= 2.0，支持 visionOS 26
  • ✨ 內建支持 XREAL Air2 Ultra（需要 XREAL SDK >= 3.1）
    • ✨ 不再需要導入單獨的支持包
    • ⚡ 優化 XREAL 上的運行效果
    • 🔥 移除 XREAL Light 支持
  • ✨ 通過 EasyAR Sense Unity Plugin 擴展分發 Pico 及 Rokid 等其它設備支持
    • ✨ 提供第三方設備接入的參考模板 com.easyar.sense.ext.hmdtemplate
    • ✨ 支持 Pico 4 Ultra Enterprise（需要 PICO Unity Integration SDK >= 3.1）
    • ✨ 支持 Rokid AR Studio（需要 Rokid Unity OpenXR Plugin >= 3.0.3）
    • ✨ 這些擴展將支持今後多個版本的 EasyAR Sense Unity Plugin
  • ✨ 支持 EasyAR XR License
    • 🔧 頭顯上使用 EasyAR 需要 EasyAR XR License 並保證首次聯網（試用需每次聯網）

完善 Unity 組件接口，大幅優化 ARSession 工作流：

  • 🚀 完善 Unity 組件層封裝
    • ✨ 完善場景組件，提供所有 EasyAR Sense 功能
    • 🔥 移除所有通過組件封裝的 EasyAR Sense 層接口
    • 🔥 移除所有內部接口
  • ✨ ARSession：重寫並大幅優化工作流
    • ✨ 支持在任意時刻啓動和停止 session
    • ✨ 支持 session 自動啓動控制
    • ✨ 支持不黑屏切換 session 功能和輸入源
    • ✨ 簡化設備支持判斷，以一致接口提供
    • ✨ 啓動時更新 MotionTracker、ARCore、AR Engine 的設備支持列表
    • ✨ 支持設備列表更新後 session 自動重啓
    • ✨ 支持獲取詳細 session 損壞信息
    • ✨ 添加 session 內部狀態自檢
    • 🔥 移除 ARComponentPicker，其功能由其餘 session 流程替代
    • 🔥 禁止多個 ARSession 同時運行
  • ✨ ARSessionFactory：提供運行時創建 ARSession 及相關組件的功能
    • ✨ 支持通過 ARSessionFactory 運行時創建與編輯器菜單相同的 session
    • ✨ 添加 Frame Source 排序功能（含菜單項）
  • ✨ FrameSource：添加慣導和 3DoF 支持
    • ✨ 添加 InertialCameraDeviceFrameSource 用於支持慣性導航
    • ✨ 添加 ThreeDofCameraDeviceFrameSource 用於支持 3DoF 的相機
    • ✨ 添加菜單功能：Frame Source by Transform Type，提供所有內置 FrameSource 的列表
    • ⚡ 優化 Inspector 選項
  • ✨ 其它接口調整及功能更新
    • ✨ 添加使用 Texture2D 創建 ImageTarget 的功能
    • ✨ 添加 ImageMaterial 用於渲染 Image 類型的數據（相機圖像或 Target 圖像等）
    • ✨ 添加 ActiveController 用於控制 GameObject 的 active，統一相關控制邏輯
    • ✨ 添加在桌面上模擬屏幕旋轉的功能
    • ✨ 添加 XROriginChildController，控制 Session 原點下物體的行爲
    • 🔥 移除 WorldRootController
    • 🔧 稀疏空間地圖接口拆分成 Builder 和 Tracker 兩個不同功能組件
    • 🔧 調整 EasyARController，提供應用/系統級靜態功能
    • 🔧 統一 Target 組件接口
    • 🔧 統一服務訪問數據的接口

新增多個開發及診斷工具：

  • 🚀 添加編輯時診斷工具：Session Validaion Tool
    • ✨ 簡化在任意場景中播放 eif
    • ✨ 支持控制 eif 播放流程
    • ✨ 支持控制 session 流程
  • 🚀 添加運行時診斷面板：EasyAR Diagnostics Panel
    • ✨ 添加 Developer Mode 開關，默認點擊屏幕 8 次開啓和關閉 Diagnostics Panel，簡化線上 app 錄製 eif 和問題反饋
    • ✨ 支持自定義 Developer Mode 開關，使用自定義交互開關 Diagnostics Panel
    • ✨ 支持控制 eif 錄製
    • ✨ 支持控制 session 信息顯示
    • ✨ 支持控制 eed 錄製
  • ✨ 添加全新的 EIF 錄製和播放功能
    • ✨ FrameRecorder 會自動組裝進 ARSession，不再需要手動選擇
    • ✨ FrameRecorder 會默認自動生成文件名以支持無腳本使用
    • ✨ FramePlayer 使用新格式錄製的數據支持播放跳轉及速度調節，文件體積降低
    • 🔧 支持在電腦上使用 eif 驅動場景和 AR 功能（非新功能）
  • ✨ 添加 DiagnosticsController，統一和優化診斷功能
    • ✨ 添加信息分級顯示及控制，默認所有錯誤及警告信息都會通過 UI 展示
    • ✨ 添加顯示 ARSession 及其組件的關鍵狀態信息的功能，默認會通過 UI 展示並每幀更新
    • 🔧 使用診斷功能簡化問題反饋信息的獲取
    • 🔥 刪除 GUIPopup
  • 🔧 優化異常狀態行爲及錯誤信息展示
    • 🔧 優化無可用 frame source 時的錯誤信息
    • 🔧 URP 環境使用 EasyAR 而非 AR Foundation 或頭顯渲染相機圖像時，未正確配置 RendererFeature 會報錯並中斷 ARSession 執行
    • 🔧 修改 Origin 默認的 Active 控制策略，在跟蹤丟失時內容貼屏而非消失
    • 🔧 自定義相機或頭顯上使用試用產品時，到達限制時間將隱藏所有內容以避免效果誤判
  • 🔧 優化配置頁面內容和選項
    • ✨ 支持選擇 EasyAR Sense 庫的變種
    • 🔒 應用權限部分除相機權限外，其餘權限不再可改，由 EasyAR Sense 庫變種及 Mega 是否啓用而決定
    • 🔧 功能及服務器配置按 EasyAR 功能分組
    • 🔧 集中管理第三方 AR SDK 配置
    • 🔧 集中管理針對 Unity 的 Workaround 配置

EasyAR Mega 工具全面公開：

  • 🚀 全面公開，同步更新
    • ✨ 集成發佈 Mega Studio 2.12
    • 🔧 Unity 側 Mega 工具將逐步合併進插件內部，今後仍將只提供最新版本的整合包，但將與 EasyAR Sense Unity Plugin 常規更新合併發佈
    • 🔧 EasyAR Mega 仍需通過 EasyAR 網站頁面 申請並通過後才能使用
  • ✨ 新增支持 EasyAR Mega Landmark
  • ✨ 新增支持 5DOF 慣導並默認開啓，進一步大幅拓展 EasyAR Mega 的設備支持
  • ✨ 新增支持使用 API Token 訪問 Mega 服務
  • 🔧 優化 Mega 效果及開發體驗（包含在過去更新的 4.7.x 版本內）
    • ✨ 支持 3DOF 純旋轉模式和 0DOF 模式（默認未啓用）
    • ✨ 添加 EditorCameraDeviceFrameSource 用於編輯器診斷，避免由於不完整的複製 sample 導致手機上錯誤運行
    • ✨ 使用 Mega時錄製老版本 eif 數據，FrameRecorder 將自動生成 .eif.json 文件
    • 🔧 使用 LocationInputMode 替代遠程調試的退化選項
    • 🔧 拆分無跟蹤模式爲獨立組件，通常不再需要使用和關注
    • 🔧 添加 BlockRootSource 選項，默認配置下忘記設置 BlockRoot 將報錯
    • 🔧 調整定位到多 block 時的默認行爲，確保多 block 不會被默認使用
    • 🔧 調整部分接口命名
    • 🔧 在 Session 包含 Mega 但無法使用時拋出更明確的異常
    • 🔧 調整 Mega 支持的 MotionTracker 最低 QualityLevel 爲 Limited
    • 🐛 修復 CloudLocalizerStatus.WakingUp 狀態未正確轉義導致運行報錯
    • 🔧 部分優化及修改見 EasyAR Sense 的更新日誌

Sample 重寫及優化：

  • ✨ 重寫所有 sample
    • ✨ 兼容不同 Input System 配置
    • ✨ 兼容 URP17+
    • ✨ 兼容使用 AR Foundation
    • 🔧 兼容不使用 AR Foundation
    • 🔧 保留少量不含 AR Foundation 支持的 sample
    • ⚡ 優化腳本及接口調用
    • 🚚 部分 sample 已重命名
    • 🔧 替換 sample 內模型和視頻等資源
    • ⚡ 減少 streaming assets的使用，僅在展示特定功能的 sample 中使用並導入
    • ✨ 使用 Texture2D 創建 ImageTarget
  • ✨ 增加新功能和接口演示
    • ✨ 添加 Workflow_ARSession sample，用於學習 session 基礎流程和設備支持等
    • ✨ 添加 Workflow_FrameSource_ExternalImageStream sample，以視頻作爲自定義相機（不能用於頭顯）
    • ✨ 添加 Combination_BasedOn_MotionTracking sample，用於學習運動跟蹤可用時各種功能的使用、切換以及 AR Foundation 切換
    • ✨ 添加 Combination_BasedOn_AppleVisionPro sample，用於展示 Apple Visio Pro 上各種功能的使用和切換
    • ✨ 添加 Combination_BasedOn_Xreal sample，用於展示 XREAL 設備上各種功能的使用和切換
    • ✨ 添加多個 Mega sample（包含在過去更新的 4.7.x 版本內）
    • ✨ 添加 Workflow_FrameSource_CameraDevice 中切換相機尺寸和 torch 模式的功能
    • 🔥 移除單獨的 AR Foundation sample，其功能已經包含在其它 sample 中
    • 🔥 移除 FrameRecording sample，其功能已經包含在其它 sample 中
    • 🔥 移除 MotionTracking_Fusion sample，其功能已經包含在 Combination_BasedOn_MotionTracking 中
    • 🔥 移除 SurfaceTracking_ImageTarget sample，功能組合仍可用輕鬆實現
    • 🔥 移除 Camera_CustomCamera sample，如有需要仍可自行實現
    • 🔥 移除 ActionOne 和 BT350 等古早眼鏡 sample
  • ✨ 簡化 eif 錄製和播放使用
    • ✨ 所有 sample 均添加 eif 錄製按鈕，錄製的 eif 文件可在編輯器內使用
  • ✨ 重寫 launcher，加入 sample 說明
    • 🐛 修復通過 launcher 加載 sample 場景偏暗的問題

EasyAR 及第三方 AR 功能集成：

  • ⬆️ 更新 EasyAR Sense 到 4.7.0 正式版
  • ⬆️ 更新 EasyAR AR Engine Interop
  • ⬆️ 更新 ARCore SDK 到 1.46.0
  • 🔧 在部分無法合理運行 AR Engine 的手機上禁用 AR Engine
  • 🐛 修復 Unity 6 上 ClassLoader 行爲變化導致 ARCore 失效

相關主題