FrameSource Class¶
Description¶
一个frame source代表frame输入数据的数据源，它提供图像数据或同时提供运动数据。
你可以通过继承 FrameSource 的一些子类型来实现自定义相机，但你不能直接继承 FrameSource 。自定义相机通常表达一个新的设备或新的数据输入方式。
在使用个人版license或试用版Mega服务时，如果运行时选择了自定义相机，EasyAR每次启动将只能使用100秒。
Properties¶
IsHMD¶
- C#
internal protected virtual abstract bool IsHMD { }
仅当创建一个新的frame source时提供。它仅会在 ARSession.Assemble 过程中被访问。
当前frame source是否是头显。如果是头显，诊断信息将显示在相机前的3D板子上。
部分frame filter在设备上运行会有不同。
Camera¶
- C#
internal protected virtual abstract Camera Camera { }
仅当创建一个新的frame source时提供。它仅会在 ARSession.Assemble 过程中被访问。
在桌面设备或手机上，该相机代表现实环境中相机设备在虚拟世界中对应的 Camera ，其投影矩阵和位置都将与真实相机对应，受EasyAR控制。在头显上，该相机仅用于将一些诊断文字展示在眼前，不用于画面渲染，相机也不受EasyAR控制。
IsCameraUnderControl¶
- C#
internal protected virtual abstract bool IsCameraUnderControl { }
仅当创建一个新的frame source时提供。它仅会在 ARSession.Assemble 过程中被访问。
当值为ture时，session 会更新相机的transform，且会渲染相机图像.
在创建头显扩展时，它应为false。你应该完全控制场景中的3D相机。你应该处理相机渲染，尤其是在VST模式下。
Display¶
- C#
internal protected virtual abstract IDisplay Display { }
仅当创建一个新的frame source时提供。它仅会在 ARSession.Assemble 过程中被访问。
提供显示系统信息。你可以使用 Display.DefaultSystemDisplay 或 Display.DefaultHMDDisplay 来获取默认的显示信息。
IsAvailable¶
- C#
internal protected virtual abstract Optional<bool> IsAvailable { }
仅当创建一个新的frame source时提供。它仅会在 ARSession.Assemble 过程中被访问。
当前frame source是否可用。
如果数值等于null， FrameSource.CheckAvailability 会被调用，数值将在 Coroutine 结束后获取。
AvailableCenterMode¶
- C#
internal protected virtual IReadOnlyList< ARSession.ARCenterMode > AvailableCenterMode { }
仅当创建一个新的frame source时提供。它仅会在 ARSession.Assemble 过程中被访问。
所有可以使用的中心模式。
Methods¶
OnSessionStart¶
- C#
private virtual abstract void OnSessionStart( ARSession session)
仅当创建一个新的frame source时提供。它仅会在 ARSession.StartSession 过程中被访问。
处理session启动，如果这个frame source已经组装进 ARSession.Assembly 。这个方法设计上是用来做延迟初始化的，你可以在这个方法中做AR独有的初始化工作。
OnSessionStop¶
- C#
private virtual abstract void OnSessionStop()
仅当创建一个新的frame source时提供。它会在 ARSession.StopSession 或其它session停止/损坏过程中被访问。
处理session停止，如果这个frame source已经组装进 ARSession.Assembly 。你可以使用这个方法销毁 ARSession.StartSession 以及session运行中创建的资源并恢复内部状态。在session销毁之前这个方法会被保证调用。如果frame source在sessino之前销毁，它将不会被调用，且session将损坏。
CheckAvailability¶
- C#
private virtual System.Collections.IEnumerator CheckAvailability()
仅当创建一个新的frame source时提供。它仅会在 ARSession.Assemble 过程中被访问。
FrameSource.IsAvailable 等于null时用于检查frame source是否可用的 Coroutine 。