SpatialSurfaceObserver.GetObservedSurfaces Method

Definition

Namespace:

Windows.Perception.Spatial.Surfaces

Gets metadata for the set of surfaces observed within the bounding volume at the moment.

public:
 virtual IMapView<Platform::Guid, SpatialSurfaceInfo ^> ^ GetObservedSurfaces() = GetObservedSurfaces;

IMapView<winrt::guid, SpatialSurfaceInfo const&> GetObservedSurfaces();

public IReadOnlyDictionary<Guid,SpatialSurfaceInfo> GetObservedSurfaces();

function getObservedSurfaces()

Public Function GetObservedSurfaces () As IReadOnlyDictionary(Of Guid, SpatialSurfaceInfo)

Returns

IMapView<Guid,SpatialSurfaceInfo>

IReadOnlyDictionary<Guid,SpatialSurfaceInfo>

IMapView<Platform::Guid,SpatialSurfaceInfo>

IMapView<winrt::guid,SpatialSurfaceInfo>

The observed surfaces within the bounding volume. If no bounding volume has been set, no surfaces will be returned.

Windows requirements

App capabilities

spatialPerception

Remarks

Each SpatialSurfaceInfo snapshot is immutable, so you can compare their values later to see if a given surface has recently experienced a mesh update.

Correlating the Id and UpdateTime properties across multiple observations lets you identify new mesh, updated mesh and removed mesh:

• If you see a SpatialSurfaceInfo with an Id you haven't seen before, treat it as new mesh.
• If you see a SpatialSurfaceInfo with a known Id, but with a new UpdateTime, treat it as updated mesh.
• If you no longer see a SpatialSurfaceInfo with a known Id, treat it as removed mesh.