SpatialSurfaceObserver Classe
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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 SpatialSurfaceObserverfunction SpatialSurfaceObserver()Public NotInheritable Class SpatialSurfaceObserver- Héritage
- 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é. |