En esta página

XrSpatialAnchorListModel QML Type

Proporciona un modelo que contiene anclajes espaciales. Más información...

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

ListModel

Status: Technology preview

Este tipo se encuentra en fase de vista previa tecnológica y está sujeto a cambios.

Propiedades

Métodos

Descripción detallada

Este tipo proporciona una lista de anclajes espaciales, que son puntos del mundo físico que pueden rastrearse y asociarse a contenido virtual.

La lista contiene elementos que tienen una propiedad « anchor » con el tipo « XrSpatialAnchor ».

Se puede utilizar de la siguiente manera:

Repeater3D {
    model: XrSpatialAnchorListModel {
    }
    delegate: Node {
        required property XrSpatialAnchor anchor
        position: anchor.position
        rotation: anchor.rotation
        // Further use of anchor properties...
    }
}

Documentación de la propiedad

classificationFilter : enumeration

Contiene el indicador de clasificación que se utiliza para filtrar los puntos de referencia espaciales.

El filtro ClassificationFlag se representa como una combinación de indicadores:

ConstanteValor
XrSpatialAnchorListModel.Wall
XrSpatialAnchorListModel.Ceiling
XrSpatialAnchorListModel.Floor
XrSpatialAnchorListModel.Table
XrSpatialAnchorListModel.Seat
XrSpatialAnchorListModel.Window
XrSpatialAnchorListModel.Door
XrSpatialAnchorListModel.Other

classificationStringFilter : list<string>

Contiene las cadenas de clasificación utilizadas para filtrar los anclajes espaciales.

Si la propiedad « filterMode » está establecida en « Classification », esta propiedad se puede utilizar para proporcionar una lista de cadenas de clasificación adicionales con las que filtrar. A continuación, estas etiquetas se compararán con el mismo valor que el indicado por la propiedad « XrSpatialAnchor::classificationString » del ancla espacial.

Nota: Solo se comprobarán con este filtro los « spatial anchors » clasificados como « Other ».

filterMode : enumeration

Especifica el modo de filtro para los anclajes espaciales.

Almacena el modo de filtro. El modo de filtro puede ser uno de los siguientes:

ConstanteDescripción
XrSpatialAnchorListModel.AllMostrar todos los anclajes espaciales.
XrSpatialAnchorListModel.ClassificationMostrar anclajes espaciales según el indicador de filtro de clasificación proporcionado.
XrSpatialAnchorListModel.IdentifierMuestra los anclajes espaciales en función de la coincidencia con los identificadores proporcionados.

identifierFilter : list<string>

Contiene la lista de identificadores para filtrar los puntos de referencia espaciales.

Documentación del método

void requestSceneCapture()

Este método activa un escaneo para capturar o actualizar los datos espaciales del entorno actual.

Este método activa el sistema de realidad extendida (XR) subyacente para que realice una captura de la escena del entorno físico actual del usuario, con el fin de actualizar o refinar la malla espacial, lo que permite una colocación y un seguimiento más precisos de los anclajes espaciales.

Nota: Algunas plataformas no realizan esta operación de forma automática. Por ejemplo, en Quest 3, si el usuario se encuentra en un espacio que no se ha capturado anteriormente, este método no se activará automáticamente, por lo que no habrá anclajes disponibles hasta que se inicie manualmente una captura.

© 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.