XrSpatialAnchorListModel QML Type
Fournit un modèle contenant des repères spatiaux. 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
- classificationFilter : enumeration
- classificationStringFilter : list<string>
- filterMode : enumeration
- identifierFilter : list<string>
Méthodes
- void requestSceneCapture()
Description détaillée
Ce type fournit une liste d'ancrages spatiaux, qui sont des points dans le monde physique pouvant être suivis et associés à du contenu virtuel.
La liste contient des éléments dotés d’une propriété « anchor » de type « XrSpatialAnchor ».
Vous pouvez l'utiliser comme suit :
Repeater3D {
model: XrSpatialAnchorListModel {
}
delegate: Node {
required property XrSpatialAnchor anchor
position: anchor.position
rotation: anchor.rotation
// Further use of anchor properties...
}
}Documentation sur la propriété
classificationFilter : enumeration
Contient l'indicateur de classification utilisé pour filtrer les ancrages spatiaux.
Le filtre ClassificationFlag est représenté par une combinaison d'indicateurs :
| Constante | Valeur |
|---|---|
XrSpatialAnchorListModel.Wall | |
XrSpatialAnchorListModel.Ceiling | |
XrSpatialAnchorListModel.Floor | |
XrSpatialAnchorListModel.Table | |
XrSpatialAnchorListModel.Seat | |
XrSpatialAnchorListModel.Window | |
XrSpatialAnchorListModel.Door | |
XrSpatialAnchorListModel.Other |
classificationStringFilter : list<string>
Contient les chaînes de classification utilisées pour filtrer les ancrages spatiaux.
Si l'filterMode est défini sur « Classification », cette propriété peut être utilisée pour fournir une liste de chaînes de classification supplémentaires sur lesquelles effectuer le filtrage. Ces étiquettes seront alors comparées à la valeur indiquée par la propriété « XrSpatialAnchor::classificationString » de l'ancrage spatial.
Remarque : seules les « spatial anchors » classées comme « Other » seront vérifiées par rapport à ce filtre.
filterMode : enumeration
Spécifie le mode de filtrage pour les ancrages spatiaux.
Contient le mode de filtrage. Le mode de filtrage peut être l'un des suivants :
| Constant | Description |
|---|---|
XrSpatialAnchorListModel.All | Afficher toutes les ancres spatiales. |
XrSpatialAnchorListModel.Classification | Afficher les ancres spatiales en fonction de l'indicateur de filtre de classification fourni. |
XrSpatialAnchorListModel.Identifier | Affiche les ancrages spatiaux correspondant aux identifiants fournis. |
identifierFilter : list<string>
Contient la liste des identifiants permettant de filtrer les ancres spatiales.
Documentation des méthodes
void requestSceneCapture()
Cette méthode déclenche une numérisation visant à capturer ou à mettre à jour les données spatiales de l'environnement actuel.
Cette méthode déclenche le système XR sous-jacent afin qu'il effectue une capture de la scène de l'environnement physique actuel de l'utilisateur, dans le but de mettre à jour ou d'affiner le maillage spatial, ce qui permet un placement et un suivi plus précis des ancrages spatiaux.
Remarque : certaines plateformes n'effectuent pas cette opération automatiquement. Par exemple, sur le Quest 3, si l'utilisateur se trouve dans un espace qui n'a pas encore été capturé, cette méthode ne sera pas appelée automatiquement, ce qui signifie qu'aucun point d'ancrage ne sera disponible tant qu'une capture n'aura pas été déclenchée manuellement.
© 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.