XrSpatialAnchor QML Type
Suivi d'un lieu ou d'un objet spécifique dans l'espace réel. Plus d'informations...
| Import Statement: | import QtQuick3D.Xr |
| Since: | Qt 6.8 |
| Inherits: |
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 une ancre spatiale 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 de l'ancre.
Les ancres spatiales sont accessibles par l'intermédiaire de XrSpatialAnchorListModel.
Remarque : le système fournit des objets d'ancrage. Ils ne peuvent pas être créés en QML.
Voir Qt Quick 3D - XR Spatial Anchors Example pour savoir comment utiliser ce type d'objet.
Notes sur la plate-forme
Dispositifs 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"/>
Note : Vous devez configurer manuellement un espace avant de lancer une application, sinon les ancres ne seront pas disponibles.
Documentation sur les 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éfinies qui décrivent l'objectif ou le contexte d'une ancre spatiale.
| Constante | Description |
|---|---|
Classification.Unknown | L'étiquette n'a pas été définie ou identifiée. |
Classification.Wall | L'ancre représente un mur. |
Classification.Ceiling | L'ancre représente un plafond. |
Classification.Floor | L'ancre représente un plancher. |
Classification.Table | L'ancre représente une table. |
Classification.Seat | L'ancre 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'ancre n'a pas été identifiée comme l'un des types ci-dessus. Voir : classificationString |
Le tableau suivant montre la correspondance entre le type de classification dans Qt Quick 3D Xr, OpenXR et VisionOS. Si le type de classification du système ne fait pas partie des types définis, le type est défini sur Other et le type de système est fourni par la propriété classificationString.
Remarque : la chaîne de classification peut également être Other.
| Type | OpenXR | VisionOS | Description du système |
|---|---|---|---|
| Inconnu | - | - | L'étiquette n'a pas été définie ou identifiée. |
| Mur | WALL_FACE | Mur | La cheville représente un mur. |
| Plafond | CEILING | Plafond | L'ancre représente un plafond. |
| Plancher | FLOOR | Plancher | L'ancre représente un plancher. |
| Table | TABLE | Table | L'ancre représente une table. |
| Siège | COUCH | Siège | L'ancre représente un siège. |
| Fenêtre | CADRE_FENÊTRE | Fenêtre | L'ancre représente une fenêtre. |
| Porte | CADRE_PORTE | Porte | L'ancre représente une porte. |
| Autre | - | - | L'ancre représente autre chose. Voir : classificationString |
classification : enumeration [read-only]
Le type de classification de l'ancre spatiale.
Cette propriété renvoie la valeur classification type pour cette ancre (par exemple,Table ou Floor) décrivant l'objectif ou le contexte de l'ancre.
Remarque : le type de classification provenant du système peut ne pas faire partie de l'ensemble des étiquettes définies par l'énumération Classification, auquel cas le type sera défini à Other et la propriété classificationString contiendra l'étiquette 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 fait pas partie de l'ensemble des types définis par les enums Classification, l'étiquette est fixée à 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 peut être vide ou modifiée, en fonction du système et de la manière dont l'ancre est classée.
Voir également classification.
extent2D : vector2d [read-only]
L'étendue en 2D de l'ancrage spatial.
Cette propriété indique la taille de l'ancre spatiale en deux dimensions (largeur et hauteur) dans le plan X/Z. Elle est valide lorsque has2DBounds est true.
Voir également has2DBounds et offset2D.
extent3D : vector3d [read-only]
L'étendue en 3D de l'ancrage spatial.
Cette propriété spécifie le volume de l'ancre spatiale en trois dimensions (largeur, hauteur et profondeur). Elle est valide lorsque has3DBounds est true.
Voir également offset3D et has3DBounds.
has2DBounds : bool [read-only]
Indique si l'ancrage spatial a des limites en 2D.
Cette propriété vaut true si l'ancrage spatial a des limites en 2D, décrites par offset2D et extent2D, ce qui indique qu'il représente une surface plane (par exemple, un sol ou un mur).
Dans le cas contraire, elle renvoie la valeur false.
Voir également offset2D, extent2D, et has3DBounds.
has3DBounds : bool [read-only]
Indique si l'ancrage spatial a des limites en 3D.
Cette propriété renvoie true si l'ancrage spatial a des limites en 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, il renvoie false.
Voir également offset3D, extent3D, et has2DBounds.
identifier : string [read-only]
Un identifiant unique pour cet ancrage spatial.
Cette propriété contient un identifiant unique associé à l'ancrage spatial. Il s'agit du même identifiant référencé par XrSpatialAnchorListModel.
offset2D : vector2d [read-only]
Le décalage 2D de l'ancrage spatial.
Cette propriété définit le décalage des limites de l'ancre dans le plan X/Z. Elle est valide lorsque has2DBounds est true.
Voir également has2DBounds et extent2D.
offset3D : vector3d [read-only]
Le décalage 3D de l'ancrage spatial.
Cette propriété fournit le décalage 3D des limites de l'ancre (en mètres) par rapport à l'ancre position.
Voir également offset3D et has3DBounds.
position : vector3d [read-only]
La position de l'ancre spatiale.
Cette propriété renvoie la position 3D (en mètres) de l'origine de l'ancre spatiale dans le système de coordonnées de la session.
rotation : quaternion [read-only]
L'orientation de l'ancrage spatial.
Cette propriété fournit la rotation de l'ancre spatiale (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.
