Unity 相容性

本文介紹 EasyAR Sense Unity Plugin 所相容的 Unity 版本和配置要求。

Unity 版本

EasyAR Sense Unity Plugin 支援 Unity 2021.3 或更高版本。

開發 Mega 功能所需的 EasyAR Mega Studio 支援 Unity 2021.3.30 或更高版本。

提示

通常來說，EasyAR 不依賴很多變化的 Unity API，所以如果 Unity 發布了新版本，EasyAR Sense Unity Plugin 一般都可以正常使用。

EasyAR Sense Unity Plugin 從版本 4.6.4 開始支援 Unity 6 的 URP 17+ Render Graph。

開發平台

作業系統	作業系統版本	CPU 架構	補充說明
Windows	7 及以上版本（7/8.1/10/11）	x86, x86_64	Windows N/KN 版本需要安裝 Media Feature Pack 才能使用
macOS	10.15 及以上版本	x86_64, arm64

另外，需要滿足對應版本的 Unity 開發系統要求 。

發布平台

作業系統	作業系統版本	CPU 架構	補充說明
Windows	7 及以上版本（7/8.1/10/11）	x86, x86_64	Windows N/KN 版本需要安裝 Media Feature Pack 才能使用
macOS	10.15 及以上版本	x86_64, arm64
Android	5.0 及以上版本	armv7a, arm64-v8a	arm64-v8a 支援需要開啟 IL2CPP
鴻蒙（手機端）	1.0 – 4.x 原生支援 5 以上透過 Android 應用相容層支援	arm64-v8a
iOS	12.0 及以上版本	arm64	Architecture 需配置為 ARM64，不支援配置為 Universal
visionOS	2.0 及以上版本	arm64

另外，需要滿足對應版本的 Unity 的發布平台要求：

• Windows
• macOS
• Android
• iOS
• visionOS

特殊說明：

• 關於 Mac Apple silicon：

  EasyAR Sense Unity Plugin 支援在 Apple silicon 裝置上原生執行，且可以在 Unity 編輯器中正常使用。

  由於 Unity 對原生插件支援的 bug，在部分 Unity 版本中，為 "Apple silicon" 或 "Intel 64-bit + Apple silicon" 建構的應用可能無法正常工作。如果發現應用在 Mac 上無法使用，且顯示類似 "Fail to load EasyAR library" 或 "DllNotFoundException: EasyAR assembly" 的錯誤，建議使用新版本的 Unity 或向 Unity 和 Unity 社群尋求協助。

• 關於 Android 16 KB 記憶體頁面大小支援：

  EasyAR Sense Unity Plugin 從版本 4000 開始支援具有 16 KB 記憶體頁面大小的裝置。

  這是 Android 15 中引入的功能。有關該功能的更多資訊，請參閱 Android 文件中關於支援 16 KB 頁面大小的內容。

• 關於 WebGL：

  EasyAR Sense Unity Plugin 不支援 Unity 的 WebGL。

  直接使用 EasyAR 雲端服務介面（比如 CRS 服務介面）開發的功能可以發布到 Web 平台。

• 關於錄影功能：

  錄影功能僅支援 Android 平台，且需配置 Graphics API 為 OpenGLES2 或 OpenGLES3。

Graphics API

EasyAR Sense Unity Plugin 直接使用 Unity 的渲染管線，所有 Unity 中可以使用的圖形 API 都可以支援。

Scriptable Render Pipeline

EasyAR Sense Unity Plugin 支援 Universal Render Pipeline (URP) 7.0.0 或更新版本。

EasyAR Sense Unity Plugin 不支援 High Definition Render Pipeline (HDRP)。

附註

關於 Unity 6 URP 17+ render graph 支援的宣告

EasyAR 支援 Unity 6 URP 17+ render graph，但是 Unity 本身仍存在部分未解決的問題。在遇到異常情形時可以嘗試使用 Unity 提供的 URP 相容模式 。

部分問題已經在最新版本的 Unity 中得到解決，建議使用 6.2 及以上版本。

非相容模式下的已知問題包括：

1. [未解決] 當從 EasyAR 取得相機紋理（類似 ImageTracking_Coloring3D 範例及 ARSession 工作流（CameraDevice） 範例中的使用），在 iOS/Mac 裝置上可以觀察到視覺故障和偽影。我們已經在純 Unity 套件中複現該問題並報告給了 Unity： Glitches on iOS with AR Camera Image Rendering (URP 17 render graph) 。問題進展可以關注 Unity Issue UUM-87787 更新以及 Unity 未來版本的發布日誌。

   對於所有版本的 Unity 6，可以使用 部分緩解措施，預設開啟。

   對於 Unity 6.2 及更新版本，可以將 Universal Render Pipeline Asset 中的 Render Scale 設定為 0.96-1.05 以外的數值來規避這個問題。

2. [Unity 6.2 已修復] Windows DX11 上相機畫面會讓場景中的物體渲染效果不可預測。在 Unity 6.0 - 6.1 版本中，EasyAR 提供 規避選項] 且預設開啟。