VIOCameraDeviceUnion Class

这个类型已经废弃并将在今后的版本中删除。请停止继续使用。

VIOCameraDeviceUnion is obsolete and will be removed in the future. Please re-create your AR Session from 'GameObject' menu or context menu in 'Hierarchy' window. You can find replacement for VIOCameraDeviceUnion from 'EasyAR Sense -> Motion Tracking -> AR Session (Motion Tracking Preset)'.

Description

在场景中控制VIO相机设备( MotionTrackerCameraDeviceARKitCameraDeviceARCoreCameraDevice )的 MonoBehaviour ,在Unity环境下提供功能扩展。如有需要可以直接使用 VIOCameraDeviceUnion.Device


Enums

public enum VIOCameraDeviceUnion.DeviceChooseStrategy

选择VIO设备的策略。


Classes

public class VIOCameraDeviceUnion.DeviceUnion

VIO设备的集合。

public class VIOCameraDeviceUnion.MotionTrackerCameraDeviceParameters

运动跟踪参数。


MonoBehaviour Messages

protected override void Awake()

protected override void OnEnable()

protected override void OnDisable()

protected virtual void OnDestroy()


Fields

DeviceStrategy

C#

public VIOCameraDeviceUnion.DeviceChooseStrategy DeviceStrategy

选择VIO设备的策略。

DesiredMotionTrackerParameters

C#

public VIOCameraDeviceUnion.MotionTrackerCameraDeviceParameters DesiredMotionTrackerParameters

期望的运动跟踪参数,只在 VIOCameraDeviceUnion.Device 启动时使用。只有在使用 MotionTrackerCameraDevice 时有效。

CalibrationDownloaderTimeout

C#

public float CalibrationDownloaderTimeout

使用 VIOCameraDeviceUnion.CheckAvailability 检查设备是否支持时从服务器更新设备列表的超时时间(秒)。设置数值小于等于 0 可以跳过从服务器获取数据。


Properties

Device

C#

public VIOCameraDeviceUnion.DeviceUnion Device { get; }

EasyAR Sense API (Union),如果功能可以使用,可以在 VIOCameraDeviceUnion.DeviceCreatedVIOCameraDeviceUnion.DeviceClosed 事件之间访问。

IsAvailable

C#

public override Optional<bool> IsAvailable { get; }

当前frame source是否可用。

如果数值等于null,需要调用 FrameSource.CheckAvailability ,数值将在 Coroutine 结束后可以访问。这个属性会在 ARComponentPicker 选择frame source的时候使用。

WorldRoot

C#

public WorldRootController WorldRoot { get; set; }

相机运动的相对物体,如果没设置,将会自动从场景中获取或生成。

Origin

C#

public override GameObject Origin { get; }

ARSession 的原点,如果frame source可以输出运动跟踪数据。

每种运动跟踪frame source都有自己的方法来设置包含特定组件的原点物体。如果原点未设置,一些frame source会从场景中active的物体中自动选择可以使用的物体或创建一个新的物体。

AvailableCenterMode

C#

public virtual IReadOnlyList< ARSession.ARCenterMode > AvailableCenterMode { get; }

该frame source可以使用的中心模式。

Camera

C#

public virtual Camera Camera { get; set; }

在一个 ARSession 中被该frame source使用的 Camera

每种frame source都有自己的方法来检查camera是否可用,设置不可用的camera将会被拒绝。这个属性会在 ARComponentPicker 选择frame source时用来判断frame source是否可用。在这个过程中,如果数值没有设置,一些frame source会从场景中active的物体中自动选择可以使用的 Camera 。你可以在session start前设置可用的 Camera 。如果这个frame source被 ARSession 选用,这个数值将在session ready后无法修改。


Events

DeviceCreated

C#

public event Action DeviceCreated

VIOCameraDeviceUnion.Device 创建的事件。

DeviceOpened

C#

public event Action DeviceOpened

VIOCameraDeviceUnion.Device 打开的事件。

DeviceClosed

C#

public event Action DeviceClosed

VIOCameraDeviceUnion.Device 关闭的事件。


Methods

CheckAvailability

C#

public override System.Collections.IEnumerator CheckAvailability()

FrameSource.IsAvailable 等于null时用于检查frame source是否可用的 Coroutine

HitTestAgainstHorizontalPlane

C#

public List< Vector3 > HitTestAgainstHorizontalPlane( Vector2 pointInView)

在当前视野内实时检测到的水平面上进行Hit Test,点击到某个水平面后返回该平面上距离Hit Test射线最近的3D点的位置坐标。 pointInView 需要被归一化到[0, 1]^2。

HitTestAgainstPointCloud

C#

public List< Vector3 > HitTestAgainstPointCloud( Vector2 pointInView)

在当前点云中进行Hit Test,得到距离相机从近到远一条射线上的最近的一个3D点位置坐标。 pointInView 需要被归一化到[0, 1]^2。

Open

C#

public void Open()

打开设备。

Close

C#

public void Close()

关闭设备。