En esta página

XrSpatialAnchorListModel QML Type

Proporciona un modelo que contiene anclajes espaciales. Más...

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

ListModel

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 contenidos virtuales.

La lista contiene elementos que tienen una propiedad anchor del 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...
    }
}

Propiedad Documentación

classificationFilter : enumeration

Contiene la bandera de clasificación utilizada para filtrar las anclas espaciales.

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

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 filterMode se establece en Classification, esta propiedad puede utilizarse para proporcionar una lista de cadenas de clasificación adicionales para filtrar. Estas etiquetas se compararán con el mismo valor indicado por la propiedad XrSpatialAnchor::classificationString del anclaje espacial.

Nota: Sólo spatial anchors que se clasifique como Other se comprobará con este filtro.

filterMode : enumeration

Especifica el modo de filtro para los anclajes espaciales.

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

ConstanteDescripción
XrSpatialAnchorListModel.AllMostrar todas las anclas espaciales.
XrSpatialAnchorListModel.ClassificationMostrar las anclas espaciales en función del indicador de filtro de clasificación proporcionado.
XrSpatialAnchorListModel.IdentifierMostrar las anclas espaciales en función de los identificadores proporcionados.

identifierFilter : list<string>

Contiene la lista de identificadores para filtrar los anclajes espaciales.

Documentación del método

void requestSceneCapture()

Este método activa una exploración para capturar o actualizar los datos espaciales del entorno actual.

Este método activa el sistema XR subyacente para realizar una captura de escena del entorno físico actual del usuario, para actualizar o refinar la malla espacial, permitiendo una colocación y un seguimiento más precisos de los anclajes espaciales.

Nota: Algunas plataformas no realizan esta operación automáticamente. Por ejemplo, en Quest 3, si el usuario se encuentra en un espacio no capturado previamente, este método no se llamará automáticamente, lo que resultará en que no haya anclajes disponibles hasta que se active 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.