SpatialAnchor Classe

Définition

Espace de noms:

Windows.Perception.Spatial

Représente un système de coordonnées fortement ancré à un point dans l’environnement de l’utilisateur.

public ref class SpatialAnchor 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 SpatialAnchor 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 SpatialAnchor

Public NotInheritable Class SpatialAnchor

Héritage

Object Platform::Object IInspectable SpatialAnchor

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

Vous pouvez créer un SpatialAnchor à n’importe quelle position et orientation dans le SpatialCoordinateSystem de votre choix. L’appareil doit être en mesure de localiser ce système de coordonnées pour le moment, et le système ne doit pas avoir atteint sa limite d’ancres spatiales.

Une fois défini, le système de coordonnées d’un SpatialAnchor s’ajuste continuellement pour conserver la position et l’orientation précises de son emplacement initial. Vous pouvez ensuite utiliser ce SpatialAnchor pour afficher des hologrammes qui apparaîtront fixes dans l’environnement de l’utilisateur à cet emplacement exact.

Les effets des ajustements qui maintiennent l’ancre en place sont amplifiés à mesure que la distance de l’ancre augmente. Vous devez éviter de rendre le contenu par rapport à une ancre qui se trouve à plus de 3 mètres de l’origine de cette ancre.

Vous pouvez conserver un SpatialAnchor à l’aide de la classe SpatialAnchorStore , puis le récupérer dans une session d’application ultérieure.

La propriété CoordinateSystem obtient un système de coordonnées qui vous permet de placer le contenu par rapport à l’ancre, avec un assouplissement appliqué lorsque l’appareil ajuste l’emplacement précis de l’ancre.

Utilisez la propriété RawCoordinateSystem et l’événement RawCoordinateSystemAdjusted correspondant pour gérer ces ajustements vous-même.

Le système de coordonnées est droitier, avec +y vers le haut, +x à droite et -z vers l’avant.

Historique des versions

Version de Windows	Version du SDK	Valeur ajoutée
1607	14393	RemovedByUser

Propriétés

CoordinateSystem	Obtient le système de coordonnées de l’ancre, avec des ajustements d’accélération appliqués.
RawCoordinateSystem	Obtient le système de coordonnées de l’ancre, sans faciliter l’application.
RemovedByUser	Obtient une valeur indiquant si l’ancre persistante a été supprimée par l’utilisateur.

Méthodes

TryCreateRelativeTo(SpatialCoordinateSystem)	Crée une ancre à l’origine du système de coordonnées spécifié.
TryCreateRelativeTo(SpatialCoordinateSystem, Vector3)	Crée une ancre à une position spécifique dans le système de coordonnées spécifié.
TryCreateRelativeTo(SpatialCoordinateSystem, Vector3, Quaternion)	Crée une ancre à une position et une orientation spécifiques dans le système de coordonnées spécifié. Cela peut retourner null si le système a atteint sa limite sur les ancres spatiales. Il peut également retourner null si le système de coordonnées spécifié ne peut pas se trouver dans cette trame.

Événements

RawCoordinateSystemAdjusted

Se produit lorsque l’appareil ajuste l’emplacement précis de l’ancre, ce qui met à jour RawCoordinateSystem.