ThreeDofCameraDevice Class¶

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

这个类型已经部分封装进Unity组件： ThreeDofCameraDeviceFrameSource 。在大部分情况下不需要直接使用这个类型的成员和实例。如果要使用一些没有被封装的接口，需要使用 ThreeDofCameraDeviceFrameSource.Device ，而非创建新的实例。

Description¶

ThreeDofCameraDevice实现了一个three dof的camera设备，输出 InputFrame （包含图像、摄像机参数、时间戳、位姿转换矩阵和跟踪状态）。

创建之后，可以调用start/stop来开始和停止采集视频流数据。

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

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

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

Methods¶

.ctor¶

C#: public ThreeDofCameraDevice()

默认创建方法，会得到一个 CameraTransformType 为ThreeDofRotOnly的 InputFrame 。

isAvailable¶

C#: public static bool isAvailable()

检查是否可用。只在Android或iOS上且陀螺仪可用时返回true。

bufferCapacity¶

C#: public virtual int bufferCapacity()

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

setBufferCapacity¶

C#: public virtual void setBufferCapacity(int capacity)

设置 InputFrame 缓冲的容量。

inputFrameSource¶

C#: public virtual InputFrameSource inputFrameSource()

InputFrame 输出端口。

setFocusMode¶

C#: public virtual void setFocusMode( ThreeDofCameraDeviceFocusMode focusMode)

设置对焦模式为focusMode。在start之前调用。

size¶

C#: public virtual Vec2I size()

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

supportedSizeCount¶

C#: public virtual int supportedSizeCount()

获取当前设备支持的所有图像大小的个数。在成功的open之后调用。

supportedSize¶

C#: public virtual Vec2I supportedSize(int index)

获取当前设备支持的所有图像大小的第 index 个. 如果 index 超出范围则返回{0, 0}。在成功的open之后调用。

setSize¶

C#: public virtual bool setSize( Vec2I size)

设置当前图像大小。最接近设置值的可选值将被使用。可以使用size来获取实际的大小。在成功的open之后调用。设置size后frameRateRange可能会发生变化。

open¶

C#: public virtual bool open()

打开设备的后置camera，如果打开失败会返回false。

start¶

C#: public virtual bool start()

开始采集视频流数据。

stop¶

C#: public virtual void stop()

停止采集视频流数据。

close¶

C#: public virtual void close()

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