XrSpatialAnchorListModel QML Type
Proporciona un modelo que contiene anclajes espaciales. Más información...
| Import Statement: | import QtQuick3D.Xr |
| Since: | Qt 6.8 |
| Inherits: | |
| Status: | Technology preview |
Este tipo se encuentra en fase de vista previa tecnológica y está sujeto a cambios.
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 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:
| 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 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:
| Constante | Descripción |
|---|---|
XrSpatialAnchorListModel.All | Mostrar todos los anclajes espaciales. |
XrSpatialAnchorListModel.Classification | Mostrar anclajes espaciales según el indicador de filtro de clasificación proporcionado. |
XrSpatialAnchorListModel.Identifier | Muestra 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.