Sur cette page

XrSpatialAnchorListModel QML Type

Fournit un modèle contenant des ancres spatiales. Plus d'informations...

Import Statement: import QtQuick3D.Xr
Since: Qt 6.8
Inherits:

ListModel

Propriétés

Méthodes

Description détaillée

Ce type fournit une liste d'ancres spatiales, qui sont des points du monde physique pouvant être suivis et associés à un contenu virtuel.

La liste contient des éléments qui ont 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...
    }
}

Propriété Documentation

classificationFilter : enumeration

Contient l'indicateur de classification utilisé pour filtrer les ancres spatiales.

Le filtre ClassificationFlag est représenté par une combinaison de drapeaux :

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 ancres spatiales.

Si filterMode est défini sur Classification, cette propriété peut être utilisée pour fournir une liste de chaînes de classification supplémentaires à filtrer. Ces étiquettes seront alors comparées à la même valeur que celle indiquée par la propriété XrSpatialAnchor::classificationString de l'ancrage spatial.

Remarque : seuls les spatial anchors qui sont classés comme Other seront vérifiés par rapport à ce filtre.

filterMode : enumeration

Spécifie le mode de filtrage pour les ancres spatiales.

Maintient le mode de filtrage. Le mode de filtrage peut être l'un des suivants :

ConstanteDescription
XrSpatialAnchorListModel.AllAfficher tous les ancrages spatiaux.
XrSpatialAnchorListModel.ClassificationAfficher les ancres spatiales en fonction de l'indicateur de filtre de classification fourni.
XrSpatialAnchorListModel.IdentifierAfficher les ancres spatiales en fonction de la correspondance avec les identifiants fournis.

identifierFilter : list<string>

Contient la liste des identifiants pour le filtrage des ancres spatiales.

Documentation de la méthode

void requestSceneCapture()

Cette méthode déclenche un balayage pour capturer ou mettre à jour les données spatiales de l'environnement actuel.

Cette méthode déclenche le système XR sous-jacent pour effectuer une capture de scène de l'environnement physique actuel de l'utilisateur, afin de mettre à jour ou d'affiner le maillage spatial, ce qui permet un placement et un suivi plus précis des ancres spatiales.

Remarque : certaines plateformes n'effectuent pas cette opération automatiquement. Par exemple, sur 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'il n'y aura pas d'ancrage 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.