ARCoreCameraDevice Class¶
这个类型是C#语言的 EasyAR Sense API: ARCoreCameraDevice 。页面中部分描述可能与Unity环境无关。
这个类型已经部分封装进Unity组件: ARCoreFrameSource 。在大部分情况下不需要直接使用这个类型的成员和实例。如果要使用一些没有被封装的接口,需要使用 ARCoreFrameSource.Device ,而非创建新的实例。
Description¶
ARCoreCameraDevice实现了一个基于ARCore的camera设备,输出 InputFrame (包含图像、摄像机参数、时间戳、6DOF位置信息和跟踪状态)。
使用时需要先使用java.lang.System.loadLibrary加载libarcore_sdk_c.so。
创建之后,可以调用start/stop来开始和停止采集视频流数据。
当不再需要该设备时,可以调用close对其进行关闭。close之后不应继续使用。
ARCoreCameraDevice通过inputFrameSource输出 InputFrame ,应将inputFrameSource连接到 InputFrameSink 上进行使用。参考 概览 。
bufferCapacity表示 InputFrame 缓冲的容量,如果有超过此数量的 InputFrame 从该设备中输出并且没有被释放,该设备将不再输出新的 InputFrame ,直到之前的 InputFrame 被释放。这可能造成画面卡住等问题。参考 概览 。
注意:当前ARCore(v1.13.0)的实现在创建和销毁session时存在内存泄漏,多次创建和销毁会导致内存占用不断增长且销毁后也不释放。
Methods¶
isAvailable¶
- C#
public static bool isAvailable()
检查是否可用。只在Android系统上并安装了ARCore时返回true。
在没有加载libarcore_sdk_c.so时调用会返回false。
注意:如果设备不支持ARCore,但却通过旁加载方式安装了ARCore的apk,则该函数会返回true,但ARCore不能正常使用。
isDeviceSupported¶
- C#
public static bool isDeviceSupported()
检查当前设备是否支持。
bufferCapacity¶
- C#
public virtual int bufferCapacity()
InputFrame 缓冲的容量,默认值为8。
setBufferCapacity¶
- C#
public virtual void setBufferCapacity(int capacity)
设置 InputFrame 缓冲的容量。
inputFrameSource¶
- C#
public virtual InputFrameSource inputFrameSource()
InputFrame 输出端口。
inputFrameSourceType¶
- C#
public virtual InputFrameSourceType inputFrameSourceType()
InputFrame来源类型。
setFocusMode¶
- C#
public virtual void setFocusMode( ARCoreCameraDeviceFocusMode focusMode)
设置对焦模式为focusMode。在start之前调用。
start¶
- C#
public virtual bool start()
开始采集视频流数据。
stop¶
- C#
public virtual void stop()
停止采集视频流数据。
close¶
- C#
public virtual void close()
关闭。close之后不应继续使用。