XrSpatialAnchorListModel QML Type
Proporciona un modelo que contiene anclajes espaciales. Más...
| Import Statement: | import QtQuick3D.Xr |
| Since: | Qt 6.8 |
| Inherits: |
Propiedades
- classificationFilter : enumeration
- classificationStringFilter : list<string>
- filterMode : enumeration
- identifierFilter : list<string>
Métodos
- void requestSceneCapture()
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:
| Constante | Valor |
|---|---|
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:
| Constante | Descripción |
|---|---|
XrSpatialAnchorListModel.All | Mostrar todas las anclas espaciales. |
XrSpatialAnchorListModel.Classification | Mostrar las anclas espaciales en función del indicador de filtro de clasificación proporcionado. |
XrSpatialAnchorListModel.Identifier | Mostrar 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.