SpatialLocator Classe

Définition

Espace de noms:

Windows.Perception.Spatial

Fournit l’accès à l’emplacement d’un appareil suivi par rapport à l’environnement de l’utilisateur, tel qu’un HoloLens ou un autre casque Mixed Reality.

public ref class SpatialLocator sealed

/// [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 SpatialLocator final

[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 SpatialLocator

Public NotInheritable Class SpatialLocator

Héritage

Object Platform::Object IInspectable SpatialLocator

Attributs

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

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)

Remarques

La classe SpatialLocator représente un appareil dont la position et l’orientation peuvent être suivies par Windows par rapport à l’environnement de l’utilisateur. Un instance SpatialLocator est la source des trames de référence fixes et attachées à un localisateur. Sur un casque Mixed Reality comme HoloLens, ces images de référence peuvent être utilisées pour le rendu holographique et pour le raisonnement sur les surfaces dans le monde autour de l’appareil.

Propriétés

Locatability

Obtient l’état actuel du système d’emplacement spatial de l’appareil.

Méthodes

CreateAttachedFrameOfReferenceAtCurrentHeading()	Crée un cadre de référence attaché positionlement à ce SpatialLocator avec l’orientation actuelle comme titre fixe.
CreateAttachedFrameOfReferenceAtCurrentHeading(Vector3)	Crée un cadre de référence qui est attaché positionlement à ce SpatialLocator avec l’orientation actuelle comme titre fixe et dont l’origine est décalée par la position relative spécifiée.
CreateAttachedFrameOfReferenceAtCurrentHeading(Vector3, Quaternion)	Crée un cadre de référence qui est attaché positionlement à ce SpatialLocator avec l’orientation actuelle comme titre fixe et avec son décalage d’origine et pivoté par la position et l’orientation relatives spécifiées.
CreateAttachedFrameOfReferenceAtCurrentHeading(Vector3, Quaternion, Double)	Crée un cadre de référence qui est attaché positionlement à ce SpatialLocator avec le titre fourni en radians par rapport à l’orientation actuelle et dont l’origine est décalée par la position et l’orientation relatives spécifiées.
CreateStationaryFrameOfReferenceAtCurrentLocation()	Crée un cadre de référence qui reste stationnaire par rapport à l’environnement de l’utilisateur, avec son origine initiale à l’emplacement actuel du SpatialLocator.
CreateStationaryFrameOfReferenceAtCurrentLocation(Vector3)	Crée un cadre de référence qui reste stationnaire par rapport à l’environnement de l’utilisateur, avec son origine initiale au décalage spécifié par rapport à l’emplacement actuel de SpatialLocator.
CreateStationaryFrameOfReferenceAtCurrentLocation(Vector3, Quaternion)	Crée un cadre de référence qui reste stationnaire par rapport à l’environnement de l’utilisateur, avec son origine initiale au décalage spécifié par rapport à l’emplacement actuel du SpatialLocator, puis pivoté à la rotation spécifiée.
CreateStationaryFrameOfReferenceAtCurrentLocation(Vector3, Quaternion, Double)	Crée un cadre de référence qui reste stationnaire par rapport à l’environnement de l’utilisateur, avec son origine initiale au décalage spécifié par rapport à l’emplacement actuel de SpatialLocator le long du titre relatif spécifié dans radians, puis pivoté à la rotation spécifiée.
GetDefault()	Obtient le instance SpatialLocator qui effectue le suivi de l’emplacement de l’appareil actuel, tel qu’un HoloLens, par rapport à l’environnement de l’utilisateur.
TryLocateAtTimestamp(PerceptionTimestamp, SpatialCoordinateSystem)	Retourne une spatialLocation qui représente l’emplacement de l’appareil à l’horodatage spécifié. Les coordonnées à l’intérieur sont exprimées par rapport au système de coordonnées fourni. Si l’appareil ne peut pas se trouver dans ce système de coordonnées à l’horodatage spécifié, la valeur de retour est null. Cela peut se produire lorsque l’appareil a perdu le suivi, par exemple.

Événements

LocatabilityChanged	Se produit lorsque l’état du système d’emplacement spatial change.
PositionalTrackingDeactivating	Se produit lorsque le système d’emplacement spatial de l’appareil se désactive en raison de l’inactivité.

Voir aussi

• Exemple d’hologramme de balise