Sur cette page

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:

ListModel

Status: Technology preview

Ce type est en préversion technologique et est susceptible d'être modifié.

Propriétés

Méthodes

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 :

ConstanteValeur
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 :

ConstantDescription
XrSpatialAnchorListModel.AllAfficher toutes les ancres spatiales.
XrSpatialAnchorListModel.ClassificationAfficher les ancres spatiales en fonction de l'indicateur de filtre de classification fourni.
XrSpatialAnchorListModel.IdentifierAffiche 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.