SpatialLocator 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 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 SpatialLocatorPublic NotInheritable Class SpatialLocator- 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)
|
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é. |