SpatialSurfaceObserver.GetObservedSurfaces Method

Reference

Definition

Namespace:: Windows.Perception.Spatial.Surfaces

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Edit

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

IReadOnlyDictionary<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.

Applies to

Product	Versions
WinRT	Build 10586, Build 14383, Build 15063, Build 16299, Build 17134, Build 17763, Build 18362, Build 19041, Build 20348, Build 22000, Build 22621, Build 26100

Share via