Version: 5.6
空间映射基本低级 API 用法
空间映射 (Spatial Mapping) 组件

空间映射最佳实践

由于空间映射可能生成的数据量以及生成该数据对速度和性能的影响,因此在使用低级 API 时需要考虑许多问题。

如果没有仔细规划应用程序对空间映射的使用,应用程序的速度和性能可能会很差。以下是空间映射可能产生的一些潜在问题,以及有关如何解决这些问题的最佳实践建议。

问题:生成碰撞数据非常慢

生成碰撞数据时会在生成空间映射数据时使用大部分 CPU 算力。请求不会被使用的碰撞数据会不必要地占用 CPU 资源并缩短电池续航时间。

最佳实践解决方案:

  • 仅在必要时请求碰撞数据。避免在不需要时请求碰撞数据可降低其他空间映射请求的延迟,并延长电池续航时间。
  • 仅请求最重要的__表面__。使用__表面__的更新时间和包围盒来确定数据请求的优先级。

问题:较高的三角形密度会产生大量几何体

You can specify high values of trianglesPerCubicMeter in the SurfaceData struct when requesting Surface data through RequestMeshAsync. This generates a very large amount of geometry, especially in spaces with a lot of objects such as a cluttered office. Large amounts of geometry increase data generation latency and memory usage. In addition, higher Mesh densities can make run-time systems such as rendering and physics run more slowly.

最佳实践解决方案:

  • 请求所需的空间映射数据的最小分辨率。请求生成的网格的较低分辨率可以减少处理请求所需花费的 CPU 时间。这样可以降低功耗,延长电池续航时间,并降低网格数据交付延迟。较低分辨率网格也对运行时性能的负面影响较小,且在内存要求方面占用的资源较少。对于期望低复杂度几何体的物理系统运行时尤其如此。

问题:太多网格请求处于排队状态导致执行不必要的工作

SurfaceObservers report all added, updated, and removed Surfaces within their volume when Update is called.

如果将所有已更改的__表面__作为一个列表添加到工作队列中,可能导致在系统删除这些表面后__表面__保留于工作队列中。删除后仍然位于工作队列中的__表面__在系统中移动时仍会占用 CPU 时间,但不生成任何网格数据。这会增加所有处于等待状态的请求的延迟时间。

最佳实践解决方案:

  • 尽可能限制工作队列中的__表面__数量。鉴于与网格工作队列相关的长延迟,一次只应使用一个 RequestMeshAsync。应用程序可以使用__表面__报告的更新时间和边界来确定 RequestMeshAsync 调用的优先级。
  • 确定__表面__数据请求的优先级,使应用程序首先获取最重要的数据。例如:
    • 新__表面__的优先级高于对现有表面的更新。
    • 更近__表面__的优先级高于更远表面。

问题:重叠或相邻的 SurfaceObservers 报告相同的网格,导致重复的 RequestMeshAsync 调用

Each SurfaceObserver reports changes for all Surfaces that overlap its volume. A Surface can overlap multiple SurfaceObserver volumes if those volumes are close, so your application code might request the same Surfaces multiple times.

最佳实践解决方案:

  • Use a single work submit queue across all SurfaceObservers. Often, a single SurfaceObserver is enough, as using just one avoids application complexity. However, there are several advanced use cases for Spatial Mapping that require multiple SurfaceObservers. In these cases, use a single queue across all SurfaceObservers to uniquely prioritize Mesh requests.
  • 如果应用程序不需要更高的复杂性,请使用单个 SurfaceObserver

问题:更新 SurfaceObserver 不会生成 onSurfaceChanged 回调

这个常见问题通常是由一个或多个设置问题引起。

最佳实践解决方案:

  • Ensure that you set a valid volume on your SurfaceObserver through a function like SetVolumeAsAxisAlignedBox.
  • 确保在 Player SettingsPublishing Settings 部分选中了 Spatial Perception
空间映射基本低级 API 用法
空间映射 (Spatial Mapping) 组件