Table of Contents

添加一组帧数据源

一个 AR Session 可以包含多个帧数据源组件,称为帧数据源组(frame source group)。在运行时,session 会根据当前设备和启用的 AR 功能,从帧数据源组中选取一个最合适的帧数据源进行使用。本文介绍了如何使用和管理帧数据源组。

开始之前

  • 了解 帧数据源 的基本概念、类型以及运行时的选取方法。

使用预设 AR Session 的帧数据源组

使用默认配置创建的 session 会自带一组帧数据源,在使用单一 AR 功能时,一般就足够了。

不同预设 session 中所包含的帧数据源不同。

使用 ARSessionFactory.ARSessionPreset.ImageTracking 预设或 AR Session (Image Tracking Preset) 菜单创建的 session 中只有单个帧数据源:

alt text

使用 ARSessionFactory.ARSessionPreset.MegaBlock_MotionTracking_Inertial 预设或 AR Session (Mega Block Default Preset) 菜单创建的 session 中包含多个帧数据源组件的场景层级结构:

alt text

如果场景中一开始使用了某个预设创建了 session,在迭代过程中增加其它功能时,不仅需要添加相应的 frame filter 组件,还需要根据需要添加合适的帧数据源组件。

重要事项

从 4.7 或更低版本升级后,需要整个删除 session 后重新通过菜单或 ARSessionFactory 创建 session,才能使用预设的帧数据源组。

以下列出了所有预设的 AR 功能默认配置的帧数据源组件,注意列表中的排序与场景中帧数据源的组件排序相同:

预设 帧数据源组
  1. CameraDeviceFrameSource
  1. XREALFrameSource
  2. AREngineFrameSource
  3. ARCoreFrameSource
  4. ARCoreARFoundationFrameSource
  5. ARKitFrameSource
  6. ARKitARFoundationFrameSource
  7. VisionOSARKitFrameSource
  8. MotionTrackerFrameSource
  1. XREALFrameSource
  2. AREngineFrameSource
  3. ARCoreFrameSource
  4. ARCoreARFoundationFrameSource
  5. ARKitFrameSource
  6. ARKitARFoundationFrameSource
  7. VisionOSARKitFrameSource
  8. MotionTrackerFrameSource
  9. EditorCameraDeviceFrameSource
  1. XREALFrameSource
  2. AREngineFrameSource
  3. ARCoreFrameSource
  4. ARCoreARFoundationFrameSource
  5. ARKitFrameSource
  6. ARKitARFoundationFrameSource
  7. VisionOSARKitFrameSource
  8. MotionTrackerFrameSource
  9. InertialCameraDeviceFrameSource
  10. EditorCameraDeviceFrameSource
  1. XREALFrameSource
  2. AREngineFrameSource
  3. ARCoreFrameSource
  4. ARCoreARFoundationFrameSource
  5. ARKitFrameSource
  6. ARKitARFoundationFrameSource
  7. VisionOSARKitFrameSource
  8. MotionTrackerFrameSource
  9. InertialCameraDeviceFrameSource
  10. ThreeDofCameraDeviceFrameSource
  11. EditorCameraDeviceFrameSource
  1. XREALFrameSource
  2. AREngineFrameSource
  3. ARCoreFrameSource
  4. ARCoreARFoundationFrameSource
  5. ARKitFrameSource
  6. ARKitARFoundationFrameSource
  7. VisionOSARKitFrameSource
  8. MotionTrackerFrameSource
  9. InertialCameraDeviceFrameSource
  10. ThreeDofCameraDeviceFrameSource
  11. CameraDeviceFrameSource
  1. XREALFrameSource
  2. AREngineFrameSource
  3. ARCoreFrameSource
  4. ARCoreARFoundationFrameSource
  5. ARKitFrameSource
  6. ARKitARFoundationFrameSource
  7. VisionOSARKitFrameSource
  8. MotionTrackerFrameSource
  9. CameraDeviceFrameSource
注意

使用预设创建的组件排序可以保证在所有受内置帧数据源支持的设备上使用最优的帧数据源。

使用默认帧数据源配置

在使用默认参数时,帧数据源的配置会根据设备和运行时启用的 AR 功能自动调整。

如果手动修改过帧数据源的参数,在 session 中的 AR 功能发生变化时(比如在原本只包含图像跟踪的 session 中新增了运动跟踪功能),可能需要手动调整帧数据源的参数以适应新的功能需求,这样所有 AR 功能才能以最佳效果运行。

重要事项

从 4.7 或更低版本升级后,需要整个删除 session 后重新通过菜单或 ARSessionFactory 创建 session,才能使用正确的默认参数。

添加帧数据源组

Hierarchy 视图中,选中 AR Session (EasyAR) 并点击右键,通过菜单 EasyAR Sense > [ AR 功能 ] > Frame Source : * 可以添加适合该功能的 frame source 组件。也可以通过菜单 EasyAR Sense > Frame Source by Transform Type > * Dof > Frame Source : * 添加需要的 frame source 组件。

在脚本中,可以使用 ARSessionFactory.AddFrameSource<Source>(GameObject, bool) 来添加 frame source 组件。

比如,通过菜单 EasyAR Sense > Frame Source by Transform Type > 3 Dof Rot-Only > Frame Source : Three Dof Camera Device 可以给当前选中的 session 添加一个 ThreeDofCameraDeviceFrameSource

alt text

对应的脚本代码如下:

ARSessionFactory.AddFrameSource<ThreeDofCameraDeviceFrameSource>(session);

帧数据源排序

session 组装过程中,帧数据源组中最终只有一个帧数据源会被选中后组装到 session 中,选取的规则取决于 AssembleOptions.FrameSourceSelection 属性的值。在默认配置下,可以通过调整帧数据源组中各个组件的排序来影响最终被选中的帧数据源。

一般可以使用在 Hierarchy 视图中 对场景中的物体进行排序 的方法直接移动 frame source 物体进行排序。

在脚本中,可以使用 Transform.SetSiblingIndex(int) 来调整物体的排序。

比如,要将 MotionTrackerFrameSource 排在其它帧数据源前面,可以在 Hierarchy 视图中选中 Motion Tracker 物体并拖动到最上面的位置。

相同的效果也可以通过下面的脚本代码实现:

motionTrackerFrameSource.transform.SetSiblingIndex(0);

另外还有一些预定义的排序方法可以使用。在 Hierarchy 视图中,选中 AR Session (EasyAR) 并点击右键,通过菜单 EasyAR Sense > Utility > Sort Frame Source : * > * 对特定的若干帧数据源组件进行排序。

在脚本中,可以使用 ARSessionFactory.SortFrameSource(GameObject, ARSessionFactory.FrameSourceSortMethod) 实现相同的效果。

比如,通过菜单 EasyAR Sense > Utility > Sort Frame Source : Motion Tracker > System SLAM 可以将 MotionTrackerFrameSource 排在 ARCoreFrameSourceARCoreARFoundationFrameSourceARKitFrameSourceARKitARFoundationFrameSourceAREngineFrameSource 前面。

alt text

对应的脚本代码如下:

ARSessionFactory.SortFrameSource(session, new ARSessionFactory.FrameSourceSortMethod { MotionTracker = ARSessionFactory.FrameSourceSortMethod.MotionTrackerSortMethod.PreferEasyAR });

经过上面的排序之后,场景层级结构变为:

alt text

相关主题