Table of Contents

EasyAR Sense Unity Plugin 發行說明

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

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

歷史版本

版本 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 and AR Foundation compatibility changes:

  • 🔧 Unity: Supports Unity 2021.3 and newer (including Unity 2022.x/Unity 6.x)
    • 🔥 Removed support for Unity 2019/Unity 2020
    • 🔥 Removed gradle version detection for Unity 2019
    • 🔥 Removed option DisableARCoreAREngine for Unity 2019
  • ✨ Unity 6: Full support for Unity 6
    • ✨ Supports URP 17+ and Render Graph
    • 🐛 Fixed: ARCore failure caused by ClassLoader behavior changes in Unity 6
    • 🐛 Fixed: Camera rendering failure when Render Scale is not 1
    • 🐛 Unity 6 native BUG: Visual glitches and artifacts observable on iOS/Mac devices. Occurs only when camera texture is required. Partial mitigation added but not fully resolved. Reported to Unity: Unity Issue UUM-87787. In Unity 6.2+, set Render Scale in Universal Render Pipeline Asset outside 0.96-1.05 range to bypass.
    • 🐛 Unity 6 native BUG: Abnormal rendering on Windows DX11. Mitigation added for Unity 6.0-6.1. Verified fixed in Unity 6.2.
  • ✨ AR Foundation: Supports AR Foundation 5+, significantly simplified usage
    • ✨ AR Foundation support integrated into plugin package, no separate import needed (disable via config option if required)
    • ✨ Supports reusing Unity.XR.CoreUtils.XROrigin as ARSession origin, reuses XROrigin Camera
    • ✨ Added Unity XR Auto Switch config option to automatically handle Unity XR (including AR Foundation) object switching
    • ✨ ARSession created via EasyAR menu automatically includes and enables AR Foundation support by default
    • ✨ Most samples added AR Foundation support (AR Foundation package requires manual import and configuration)
    • 🔧 ARCore and ARKit can be individually controlled, including priority order between EasyAR built-in ARCore/ARKit and AR Foundation's ARCore/ARKit
    • 🔥 Removed support for AR Foundation 4
    • 🔥 Removed support for ARSessionOrigin, only XROrigin supported
    • 🔥 Removed proxy execution for AR Foundation ARCore installation process
  • ✨ Fully compatible with 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 Validation 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 的更新日誌

範例重寫及最佳化：

  • ✨ 重寫所有範例
    • ✨ 相容不同輸入系統組態
    • ✨ 相容URP17+
    • ✨ 相容使用AR Foundation
    • 🔧 相容未使用AR Foundation
    • 🔧 保留少量不含AR Foundation支援的範例
    • ⚡ 最佳化指令碼及介面呼叫
    • 🚚 部分範例已重新命名
    • 🔧 替換範例內模型和影片等資源
    • ⚡ 減少streaming assets使用，僅在展示特定功能的範例中使用並匯入
    • ✨ 使用Texture2D建立ImageTarget
  • ✨ 增加新功能和介面演示
    • ✨ 新增Workflow_ARSession範例，用於學習session基礎流程和裝置支援等
    • ✨ 新增Workflow_FrameSource_ExternalImageStream範例，以影片作為自訂相機（不可用於頭戴裝置）
    • ✨ 新增Combination_BasedOn_MotionTracking範例，用於學習運動追蹤可用時各種功能的使用、切換以及AR Foundation切換
    • ✨ 新增Combination_BasedOn_AppleVisionPro範例，用於展示Apple Visio Pro上各種功能的使用和切換
    • ✨ 新增Combination_BasedOn_Xreal範例，用於展示XREAL裝置上各種功能的使用和切換
    • ✨ 新增多個Mega範例（包含在過去更新的4.7.x版本內）
    • ✨ 新增Workflow_FrameSource_CameraDevice中切換相機尺寸和手電筒模式的功能
    • 🔥 移除獨立的AR Foundation範例，其功能已包含在其它範例中
    • 🔥 移除FrameRecording範例，其功能已包含在其它範例中
    • 🔥 移除MotionTracking_Fusion範例，其功能已包含在Combination_BasedOn_MotionTracking中
    • 🔥 移除SurfaceTracking_ImageTarget範例，功能組合仍可輕鬆實現
    • 🔥 移除Camera_CustomCamera範例，如有需要仍可自行實現
    • 🔥 移除ActionOne和BT350等舊式眼鏡範例
  • ✨ 簡化eif錄製和播放使用
    • ✨ 所有範例均新增eif錄製按鈕，錄製的eif檔案可在編輯器內使用
  • ✨ 重寫啟動器，加入範例說明
    • 🐛 修復透過啟動器載入範例場景過暗的問題

EasyAR及第三方AR功能整合：

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

相關主題