SpatialSurfaceObserver 类

定义

命名空间:

Windows.Perception.Spatial.Surfaces

提供用于观察用户环境中表面的方法。

public ref class SpatialSurfaceObserver sealed

/// [Windows.Foundation.Metadata.Activatable(131072, "Windows.Foundation.UniversalApiContract")]
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 131072)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class SpatialSurfaceObserver final

[Windows.Foundation.Metadata.Activatable(131072, "Windows.Foundation.UniversalApiContract")]
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 131072)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class SpatialSurfaceObserver

function SpatialSurfaceObserver()

Public NotInheritable Class SpatialSurfaceObserver

继承

Object Platform::Object IInspectable SpatialSurfaceObserver

属性

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows 要求

设备系列	Windows 10 (在 10.0.10586.0 - for Xbox, see UWP features that aren't yet supported on Xbox 中引入)
API contract	Windows.Foundation.UniversalApiContract (在 v2.0 中引入)
应用功能	spatialPerception

注解

空间映射可让你的应用了解用户环境中表面的形状和位置。

通过 HoloLens 等设备上的传感器，Windows 生成大立方体形状表面的 3D 三角形网格。 随着时间的推移，随着 Windows 提高对周围环境的理解，将生成新的表面卷，并使用新网格更新现有卷。 有时，当系统的存储不足时，表面卷也会被销毁。

可以通过对空间量（边界框、边框或边界球体）表示兴趣来访问这些表面。 Windows 会更新你，让你知道观察到的卷中的图面集何时发生了更改，每个表面卷都由 ID 标识，以及其上次更新的时间。 通过推理这组观察到的图面元数据的更改，可以检测新的网格、更新的网格和随时间推移删除的网格。

版本历史记录

Windows 版本	SDK 版本	已添加值
1703	15063	IsSupported

构造函数

SpatialSurfaceObserver()

初始化 SpatialSurfaceObserver 类的新实例。

方法

GetObservedSurfaces()	获取当前在边界卷内观察到的一组图面的元数据。
IsSupported()	获取当前系统上是否支持空间映射。
RequestAccessAsync()	请求访问应用以使用空间映射。 这需要 spatialPerception 功能。
SetBoundingVolume(SpatialBoundingVolume)	设置此观察程序将跟踪新的、更新的或已删除的图面的单个边界卷。
SetBoundingVolumes(IIterable<SpatialBoundingVolume>)	设置此观察程序将跟踪的新图面、更新图面或已删除图面的边界卷列表。

事件

ObservedSurfacesChanged

在边界卷内观察到的一组图面元数据发生更改时发生。

另请参阅

• 全息空间映射示例