SpatialAnchor 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.
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 SpatialAnchorPublic NotInheritable Class SpatialAnchor- 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
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. |