平台需求¶
平台支持¶
请参考 EasyAR Sense 平台要求 以及 Unity System requirements 。
关于 Android arm64-v8a
Unity使用的mono脚本后台不支持Android arm64-v8a。如果需要使用应开启IL2CPP。
关于 iOS armv7 及 Universal
在iOS平台上，不支持Architecture为arm64或Universal。仅支持选择Architecture为arm64。
关于 Mac Apple silicon
备注
EasyAR Sense Unity Plugin支持在Apple silicon设备上原生运行，且可以在Unity编辑器中正常使用。但由部分Unity版本为 "Apple silicon" 或 "Intel 64-bit + Apple silicon" 构建的应用可能无法正常工作。这应该是Unity对原生插件支持的bug。如果你发现你的应用在Mac上无法使用，且显示类似 "Fail to load EasyAR library" 或 "DllNotFoundException: EasyAR assembly" 的错误，你应该向Unity或Unity社区寻求帮助。
Unity兼容性¶
EasyAR Sense Unity Plugin需要使用 Unity 2021.3 或更高版本。
通常来说, EasyAR Sense不依赖很多变化的Unity API，所以如果Unity发布了新版本，EasyAR Sense Unity Plugin一般都可以正常使用。
iOS不支持视频录制功能。
支持Unity 6（包括URP 17+ Render Graph）
Graphics API¶
EasyAR Sense Unity Plugin 直接使用Unity的渲染管线，所有Unity中可以使用的图形API都可以天然被支持。
备注
特例：由于EasyAR Sense的内部实现，录屏功能将只能在某些特定条件下工作，即在Android上Graphics API是OpenGLES2或OpenGLES3的情况下使用。
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中得到解决，建议使用6000.2以上版本的Unity6。
非兼容模式下的已知问题包括：
[未解决] 当你从EasyAR获取相机纹理（类似 ImageTracking_Coloring3D 及 Workflow_FrameSource_CameraDevice 样例中的使用），在iOS/Mac设备上可以观察到视觉故障和伪影。我们已经在纯Unity包中复现该问题并报告给了Unity： Glitches on iOS with AR Camera Image Rendering (URP 17 render graph) 。问题进展请关注 Unity Issue UUM-87787 更新以及Unity未来版本的发布日志。
对于所有版本的Unity6，可以使用 部分缓解措施 ，默认开启。
对于 Unity 6000.2.0f1及更新版本，可以将你的Universal Render Pipeline Asset中的Render Scale设置为0.96-1.05以外的数值来规避这个问题。
[Unity 6.2中 已实测修复， EasyAR中已绕过（默认开启）] Windows DX11上相机画面会让场景中的物体渲染效果不可预测。
建议在Unity的问题跟踪页面确认问题的更新，并向Unity直接反馈。
WebGL¶
EasyAR Sense Unity Plugin 不支持 Unity的WebGL。
EasyAR Sense的功能和接口不支持在Unity WebGL上使用，但你仍然可以通过直接调用EasyAR CRS或其它服务接口的方式使用EasyAR的云服务。这种情况你不再需要EasyAR Sense Unity Plugin，而是通过Unity的网络API直接调用EasyAR的相关云服务接口。
Unity AR Foundation 兼容性¶
EasyAR Sense Unity Plugin 支持 AR Foundation 5 或更新版本。仅支持 Unity.XR.CoreUtils.XROrigin ，不支持 ARSessionOrigin。
注意
AR Foundation的支持是通过EasyAR Sense的自定义相机实现的。在自定义相机或头显上使用试用产品（个人版license、试用版XR license或试用版Mega服务等）时，EasyAR Sense每次启动后会在固定的有限时间内停止响应。使用付费版本的EasyAR Sense和付费的EasyAR Mega服务没有这个限制。
ARCore 兼容性¶
EasyAR Sense Unity Plugin 内部包含了ARCore SDK 1.46.0，因此可以支持 ARCore （Google Play Services for AR） 1.46.0及以上版本。更早版本的ARCore服务是否支持需要看Google自身的兼容性。如果使用AR Foundation或其它ARCore SDK的发布，ARCore 兼容性将由这些框架决定。
如果有使用到 ARCore，需要在Unity中做如下设置
使用 IL2CPP 并在构建中包含 arm64-v8a 。在arm64的设备上运行仅有armv7的程序，ARCore不会正常工作。这个在打包时是非强制的，但如果不满足条件会弹出警告。
华为 AR Engine 兼容性¶
EasyAR Sense Unity Plugin 内部包含了AREngine SDK 3.7.0.3，支持至少AREngine 2.18及以上版本。详细兼容信息请查阅AREngine官方说明。AREngine的使用将不再受Unity版本的限制。
EasyAR Sense Unity Plugin不支持华为官方已不再维护的 Huawei AR Engine Unity SDK ，或是其它第三方发布的类似SDK。
注意
AR Engine的支持是通过EasyAR Sense的自定义相机实现的。在自定义相机或头显上使用试用产品（个人版license、试用版XR license或试用版Mega服务等）时，EasyAR Sense每次启动后会在固定的有限时间内停止响应。使用付费版本的EasyAR Sense和付费的EasyAR Mega服务没有这个限制。
头显兼容性¶
EasyAR Sense Unity Plugin 已经支持如下头显SDK/系统
Apple visionOS 2 或更新版本（支持visionOS 26及更新版本）
PICO Unity Integration SDK 3.1.0 或更新版本。
XREAL SDK 3.1 或更新版本。
Rokid Unity OpenXR Plugin 3.0.3 或更新版本（可通过Rokid Unity OpenXR Plugin支持Rokid UXR 3，但建议使用XR Interaction Toolkit，尤其是跨设备使用）。
Xrany元霓 SDK （由厂商开发维护）
备注
由于同一个SDK可以用来支持不同的设备，该文档对支持的设备可能更新不会特别及时。对于一些新设备的支持，请咨询对应硬件厂商。
目前已经确认支持的设备如下：
Apple Vision Pro
Pico 4 Ultra Enterprise（可联系EasyAR商务购买设备）
XREAL Air2 Ultra（可联系EasyAR商务购买设备）
Rokid AR Studio
Xrany X1（由厂商开发维护）
注意
Apple Vision Pro、Pico、XREAL都需要其对应的企业授权才能使用，如有疑问请联系商务。
受Apple Vision Pro接口授权限制，仅支持获取了Apple企业API许可的设备。
受Pico接口授权限制，仅支持Pico企业版设备。
受XREAL接口授权限制，仅支持获取了企业授权的设备。
其中EasyAR Sense内建支持如下头显：
Apple Vision Pro
XREAL Air2 Ultra
EasyAR还提供扩展机制以支持更多新设备，这类设备和设备SDK是受支持的，
其它通过EasyAR头显扩展接入的设备（由厂商开发维护）
请关注设备厂商的具体说明。设备厂商可以参考 如何创建EasyAR头显扩展 来接入。
注意
在自定义相机或头显上使用试用产品（个人版license、试用版XR license或试用版Mega服务等）时，EasyAR Sense每次启动后会在固定的有限时间内停止响应。使用付费版本的EasyAR Sense和付费的EasyAR Mega服务没有这个限制。
如遇头显SDK更新，大部分情况下在没有相关接口改动的情况下都是可以支持的；如果EasyAR使用的部分接口存在变化，在EasyAR更新前可以自行修改对应头显的FrameSource脚本。
注意
在4.7逐步更新版本中，部分支持的设备现已结束支持。
Pico 4 Enterprise支持已结束。
XREAL Light支持已结束。
奇遇支持已结束。