Partager via


SpatialSurfaceObserver Classe

Définition

Fournit des méthodes d’observation des surfaces dans l’environnement de l’utilisateur.

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
Héritage
Object Platform::Object IInspectable SpatialSurfaceObserver
Attributs

Configuration requise pour Windows

Famille d’appareils
Windows 10 (introduit dans 10.0.10586.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
API contract
Windows.Foundation.UniversalApiContract (introduit dans v2.0)
Fonctionnalités de l’application
spatialPerception

Remarques

Le mappage spatial permet à votre application de comprendre la forme et l’emplacement des surfaces dans l’environnement de l’utilisateur.

Grâce aux capteurs d’un appareil comme HoloLens, Windows génère des maillages triangle 3D de surfaces dans de grands volumes en forme de cube. Au fil du temps, à mesure que Windows améliore sa compréhension de votre environnement, de nouveaux volumes de surface sont générés et les volumes existants sont mis à jour avec un nouveau maillage. Parfois, les volumes de surface peuvent également être détruits, lorsque le système est à faible niveau de stockage.

Vous accédez à ces surfaces en exprimant votre intérêt pour un volume d’espace, soit un cadre englobant, un frustum englobant ou une sphère englobante. Windows vous met à jour pour vous indiquer quand l’ensemble de surfaces dans ce volume observé a changé, chaque volume de surface identifié par un ID et l’heure de sa dernière mise à jour. En raisonnant les modifications apportées à cet ensemble de métadonnées de surface observées, vous pouvez détecter un nouveau maillage, un maillage mis à jour et un maillage supprimé au fil du temps.

Historique des versions

Version de Windows Version du SDK Valeur ajoutée
1703 15063 IsSupported

Constructeurs

SpatialSurfaceObserver()

Initialise une nouvelle instance de la classe SpatialSurfaceObserver.

Méthodes

GetObservedSurfaces()

Obtient les métadonnées pour l’ensemble de surfaces observées dans le volume englobant pour le moment.

IsSupported()

Obtient si le mappage spatial est pris en charge sur le système actuel.

RequestAccessAsync()

Demande l’accès pour qu’une application utilise le mappage spatial. Cela nécessite la fonctionnalité spatialPerception.

SetBoundingVolume(SpatialBoundingVolume)

Définit le volume englobant unique que cet observateur va suivre pour les surfaces nouvelles, mises à jour ou supprimées.

SetBoundingVolumes(IIterable<SpatialBoundingVolume>)

Définit la liste des volumes englobants que cet observateur effectuera le suivi des surfaces nouvelles, mises à jour ou supprimées.

Événements

ObservedSurfacesChanged

Se produit lorsque le jeu de métadonnées de surface observé dans le volume englobant a changé.

S’applique à

Voir aussi