XrSpatialAnchor QML Type
Permet de suivre un lieu ou un objet spécifique dans l'espace réel. En savoir plus...
| Import Statement: | import QtQuick3D.Xr |
| Since: | Qt 6.8 |
| Inherits: | |
| Status: | Technology preview |
Ce type est en préversion technologique et est susceptible d’être modifié.
Propriétés
- Classification : enumeration
- classification : enumeration
- classificationString : string
- extent2D : vector2d
- extent3D : vector3d
- has2DBounds : bool
- has3DBounds : bool
- identifier : string
- offset2D : vector2d
- offset3D : vector3d
- position : vector3d
- rotation : quaternion
Description détaillée
Ce type représente un point d'ancrage spatial qui suit un emplacement ou un objet spécifique dans l'espace réel. Il fournit des informations sur la position, la rotation, la classification et les limites du point d'ancrage.
L'accès aux ancrages spatiaux s'effectue via une interface « XrSpatialAnchorListModel ».
Remarque : le système fournit des objets Anchor. Ceux-ci ne peuvent pas être créés en QML.
Consultez l’exemple «Qt Quick 3D - XR Spatial Anchors » pour savoir comment utiliser ce type.
Remarques sur la plateforme
Appareils Meta Quest
Cette API utilise les API Meta Quest Scene et Spatial Anchor. Vous devez ajouter les autorisations suivantes au fichier AndroidManifest.xml de votre application :
<uses-permission android:name="com.oculus.permission.USE_ANCHOR_API"/>
<uses-permission android:name="com.oculus.permission.USE_SCENE"/>Remarque : vous devez configurer manuellement un « Space » avant d’exécuter une application, sinon les ancrages ne seront pas disponibles.
Documentation des propriétés
Classification : enumeration [read-only]
La classification de l'ancrage spatial.
L'énumération « Classification » fournit un ensemble de types de catégories prédéfinis qui décrivent l'objectif ou le contexte d'un repère spatial.
| Constante | Description |
|---|---|
Classification.Unknown | Le libellé n’a pas été défini ni identifié. |
Classification.Wall | L'ancrage représente un mur. |
Classification.Ceiling | L’ancrage représente un plafond. |
Classification.Floor | L'ancrage représente un sol. |
Classification.Table | L'ancrage représente une table. |
Classification.Seat | L'ancrage représente un siège. |
Classification.Window | L'ancre représente une fenêtre. |
Classification.Door | L'ancre représente une porte. |
Classification.Other | L'ancrage n'a été identifié comme aucun des types ci-dessus. Voir : classificationString |
Le tableau suivant présente la correspondance entre le type de classification dans Qt Quick 3D Xr, OpenXR et VisionOS. Si le type de classification du système ne correspond à aucun des types définis, le champ « Type » est défini sur « Other » et le type du système est fourni par la propriété « classificationString ».
Remarque : la chaîne de classification peut également être « Other ».
| Type | OpenXR | VisionOS | Description |
|---|---|---|---|
| Inconnu | - | - | L'étiquette n'a pas été définie ou identifiée. |
| Mur | WALL_FACE | Mur | L'ancrage représente un mur. |
| Plafond | PLAFOND | Plafond | L'ancrage représente un plafond. |
| Sol | SOL | Sol | L'ancrage représente un plancher. |
| Table | TABLE | Table | L'ancrage représente une table. |
| Siège | CANAPÉ | Siège | L'ancre représente un siège. |
| Fenêtre | WINDOW_FRAME | Fenêtre | L'ancrage représente une fenêtre. |
| Porte | DOOR_FRAME | Porte | L'ancrage représente une porte. |
| Autre | - | - | L'ancre représente autre chose. Voir : classificationString |
classification : enumeration [read-only]
Le type de classification de l'ancrage spatial.
Cette propriété renvoie l'classification type de cette ancre (par exemple,Table ou Floor) décrivant l'objectif ou le contexte de l'ancre.
Remarque : il se peut quele type de classification fourni par le système ne figure pas dans l’ensemble des libellés définis par l’énumération Classification; dans ce cas, le type sera défini sur Other et la propriété classificationString contiendra le libellé d’origine.
Voir également classificationString.
classificationString : string [read-only]
Le type de classification de l'ancrage spatial sous forme de chaîne de caractères.
Cette propriété renvoie le type de classification sous forme de chaîne de caractères s'il existe. Si le type de classification ne figure pas dans l'ensemble des types définis par les énumérations de l'Classification, l'étiquette est définie sur « Other », et cette propriété peut être utilisée pour accéder au type tel qu'il a été signalé par le système.
Remarque : cette chaîne de caractères peut être vide ou varier en fonction du système et de la manière dont l’ancrage est classé.
Voir également classification.
extent2D : vector2d [read-only]
L'étendue en 2D de l'ancrage spatial.
Cette propriété contient les dimensions de l'ancrage spatial en deux dimensions (largeur et hauteur) dans le plan X/Z. Elle est valide lorsque has2DBounds est défini sur true.
Voir également has2DBounds et offset2D.
extent3D : vector3d [read-only]
L'étendue 3D de l'ancrage spatial.
Cette propriété spécifie le volume de l'ancrage spatial en trois dimensions (largeur, hauteur et profondeur). Elle est valide lorsque has3DBounds est défini sur true.
Voir également « offset3D » et « has3DBounds ».
has2DBounds : bool [read-only]
Indique si l'ancrage spatial possède des limites 2D.
Cette propriété prend la valeur « true » si l'ancrage spatial possède des limites 2D, décrites par offset2D et extent2D, indiquant qu'il représente une surface plane (par exemple, un sol ou un mur).
Dans le cas contraire, elle renvoie « false ».
Voir également offset2D, extent2D et has3DBounds.
has3DBounds : bool [read-only]
Indique si l'ancrage spatial possède des limites 3D.
Cette propriété renvoie « true » si l'ancrage spatial possède des limites 3D, ce qui indique qu'il représente un volume (par exemple, une table ou une armoire). Les limites sont décrites par « offset3D » et « extent3D ».
Dans le cas contraire, elle renvoie false.
Voir également offset3D, extent3D et has2DBounds.
identifier : string [read-only]
Identifiant unique de cette ancre spatiale.
Cette propriété contient un identifiant unique associé à l'ancrage spatial. Il s'agit du même identifiant que celui référencé par une entité de type « XrSpatialAnchorListModel ».
offset2D : vector2d [read-only]
Le décalage 2D de l'ancrage spatial.
Cette propriété contient le décalage des limites de l'ancrage dans le plan X/Z. Elle est valide lorsque has2DBounds est défini sur true.
Voir également has2DBounds et extent2D.
offset3D : vector3d [read-only]
Le décalage 3D de l'ancrage spatial.
Cette propriété indique le décalage 3D des limites de l'ancrage (en mètres) par rapport à l'position de l'ancrage.
Voir également offset3D et has3DBounds.
position : vector3d [read-only]
La position de l'ancrage spatial.
Cette propriété renvoie la position 3D (en mètres) de l'origine de l'ancrage spatial dans le système de coordonnées de la session.
rotation : quaternion [read-only]
L'orientation de l'ancrage spatial.
Cette propriété indique la rotation de l'ancrage spatial (sous forme de quaternion).
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.
