XREALCameraDevice Class¶

这个类型是C#语言的 EasyAR Sense API: XREALCameraDevice 。页面中部分描述可能与Unity环境无关。

部分Sense接口已经封装成Unity组件，直接使用可能是不必要的。

Description¶

XREALCameraDevice实现了一个基于XREAL Enterprise Native SDK Plugin的camera设备，输出 InputFrame （不可获取图像、摄像机参数、时间戳、6DOF位置信息和跟踪状态）。

创建之后，可以调用start/stop来开始和停止采集视频流数据。需要确保在isDeviceSupported返回true之后才能调用start。

当不再需要该设备时，可以调用close对其进行关闭。close之后不应继续使用。

XREALCameraDevice通过inputFrameSource输出 InputFrame ，应将inputFrameSource连接到 InputFrameSink 上进行使用。参考概览。

bufferCapacity表示 InputFrame 缓冲的容量，如果有超过此数量的 InputFrame 从该设备中输出并且没有被释放，该设备将不再输出新的 InputFrame ，直到之前的 InputFrame 被释放。这可能造成画面卡住等问题。参考概览。

Methods¶

isAvailable¶

C#: public static bool isAvailable()

检查是否可用。只在支持XREAL眼镜的设备上且成功连接XREAL眼镜之后返回true。

isDeviceSupported¶

C#: public static Optional<bool> isDeviceSupported()

检查眼镜是否被支持。在可用的设备上，只有XREAL完成初始化之后有值。

bufferCapacity¶

C#: public virtual int bufferCapacity()

InputFrame 缓冲的容量，默认值为8。

setBufferCapacity¶

C#: public virtual void setBufferCapacity(int capacity)

设置 InputFrame 缓冲的容量。

inputFrameSource¶

C#: public virtual InputFrameSource inputFrameSource()

InputFrame 输出端口。

getMotionInputData¶

C#: public virtual Optional< MotionInputData > getMotionInputData()

获取同步的运动输入数据。在isDeviceSupported返回true之后使用。

receivedFrameCount¶

C#: public virtual int receivedFrameCount()

从相机获取到的帧数。在start之后它应该持续增加，否则可能设备连接不稳定或XREAL服务/SDK工作不正常，这时需要直接从XREAL官方获取帮助。

open¶

C#: public virtual bool open()

打开camera设备。在isDeviceSupported返回true之后使用。在Air2 Ultra等设备上，XREAL 许可证必须先通过XREAL官方方法完成校验。

getXREALError¶

C#: public virtual Optional< XREALError > getXREALError()

获取XREAL错误，一般在open失败时可以查询是否有XREAL相关错误。

start¶

C#: public virtual bool start()

开始采集视频流数据。

stop¶

C#: public virtual void stop()

停止采集视频流数据。

close¶

C#: public virtual void close()

关闭。close之后不应继续使用。

type¶

C#: public virtual CameraDeviceType type()

camera类型。在成功的open之后调用。

cameraOrientation¶

C#: public virtual int cameraOrientation()

camera图像在设备的自然方向上显示时需要顺时针旋转的角度。在成功的open之后调用。

size¶

C#: public virtual Vec2I size()

获取当前图像大小。在成功的open之后调用。

frameRate¶

C#: public virtual double frameRate()

获取当前帧率。在成功的open之后调用。