EasyAR的头显支持¶
EasyAR和头显SDK的关系¶
EasyAR的功能与头显的功能大部分是不重叠的。所以大部分情况下,EasyAR不会代理头显的功能,当你需要使用头显的一些功能,比如手势识别等的时候,你需要按照对应头显官方的做法来使用,并从其官方了解这些功能的具体使用方法和适用范围。
对EasyAR来说,头显SDK提供了在其设备上的运动跟踪能力,EasyAR也只利用了头显的这部分功能。请阅读 运动跟踪与EasyAR功能 来了解EasyAR功能与运动跟踪的关系,以及EasyAR的什么功能可以在有运动跟踪时使用。
对Pico、Apple Vision Pro、Rokid、XREAL等等这些AR/VR显示设备来说,设备自身运行不会使用EasyAR,EasyAR补足了这些设备在一些场景下的能力。
支持的头显¶
头显扩展的导入和使用准备¶
导入头显SDK¶
从设备官方获取SDK并使用官方方法导入。这里列出几个已知头显的官方下载或文档链接,如有变化或链接失效请与头显官方确认。
Rokid UXR2 SDK ,请联系厂商获取准确文档位置
Xrany元霓 SDK (由厂商开发维护),请联系厂商获取准确文档位置
注意
使用Pico和XREAL需要使用特定版本的设备SDK,请阅读 头显工程配置
确保头显自身的 demo 可以使用¶
如果在当前工程中第一次使用某个头显的SDK,请务必先在没有EasyAR的情况下使用它自身的demo,通常来讲这些demo都需要一些特殊的工程配置,请参考其官方文档来使用。许多设备SDK都提供物理相机输入的demo,比如Rokid的 RKCameraPreview。由于EasyAR需要物理相机的输入,而很多其它demo并没有使用到物理相机,所以其它一些sample或设备本身可以显示内容并不说明已经准备好了。
小技巧
默认情况下,EasyAR会在相机前显示一些运行信息,如果头显SDK配置正确,它必然会显示出来。很多时候,使用EasyAR但看不到任何显示都是因为设备SDK配置不正确,而其本身的Demo也无法合理运行。比如,在XREAL SDK的一些版本中,你需要先解决XREAL菜单* NRSDK > Project Tips
所显示的所有错误。其它眼镜有时候也有类似配置。
导入 EasyAR Sense Unity Plugin¶
通过Unity的 Package Manager window 来 使用本地tarball文件安装插件。
在弹出的对话框中选择 com.easyar.sense-*.tgz
文件。
导入EasyAR Sense Unity Plugin头显扩展¶
一部分设备需要导入头显扩展才能支持,不同的设备SDK需要使用不同的扩展,需要通过Unity的 Package Manager window 来 使用本地tarball文件安装插件。这里列出已知一些头显扩展的包名。
Apple Vision Pro:
com.easyar.sense-*.tgz
内建支持,不需要额外Unity插件包XREAL:
com.easyar.sense-*.tgz
内建支持,不需要额外Unity插件包PICO: 需要导入Unity插件包
com.easyar.sense.ext.pico-*.tgz
Rokid: 需要导入Unity插件包
com.easyar.sense.ext.rokid.uxr-*.tgz
Xrany元霓: 需要导入Unity插件包,请根据厂商文档进行操作
头显上EasyAR的使用¶
创建我的EasyAR头显扩展¶
请阅读 如何创建EasyAR头显扩展