XrSpatialAnchor QML Type
Realiza un seguimiento de una ubicación u objeto concreto en el espacio real. 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
- Classification : enumeration
- classification : enumeration
- classificationString : string
- extent2D : vector2d
- extent3D : vector3d
- has2DBounds : bool
- has3DBounds : bool
- identifier : string
- offset2D : vector2d
- offset3D : vector3d
- position : vector3d
- rotation : quaternion
Descripción detallada
Este tipo representa un ancla espacial que realiza un seguimiento de una ubicación u objeto específico en el espacio real. Proporciona información sobre la posición, la rotación, la clasificación y los límites de la ancla.
Se accede a los anclajes espaciales a través de un ` XrSpatialAnchorListModel`.
Nota: El sistema proporciona objetos Anchor. No se pueden crear en QML.
Consulta el ejemplo «Qt Quick 3D - Anclas espaciales XR» para saber cómo utilizar este tipo.
Notas sobre la plataforma
Dispositivos Meta Quest
Esta API utiliza las API «Meta Quest Scene» y «Spatial Anchor». Debes añadir los siguientes permisos al archivo AndroidManifest.xml de tu aplicación:
<uses-permission android:name="com.oculus.permission.USE_ANCHOR_API"/>
<uses-permission android:name="com.oculus.permission.USE_SCENE"/>Nota: Debes configurar manualmente un «Space» antes de ejecutar una aplicación; de lo contrario, los anclajes no estarán disponibles.
Documentación de propiedades
Classification : enumeration [read-only]
La clasificación del ancla espacial.
La enumeración «Classification» proporciona un conjunto de tipos de categorías predefinidas que describen la finalidad o el contexto de un ancla espacial.
| Constante | Descripción |
|---|---|
Classification.Unknown | La etiqueta no se ha establecido ni identificado. |
Classification.Wall | El punto de referencia representa una pared. |
Classification.Ceiling | El punto de referencia representa un techo. |
Classification.Floor | El ancla representa un suelo. |
Classification.Table | El marcador representa una mesa. |
Classification.Seat | El ancla representa un asiento. |
Classification.Window | El ancla representa una ventana. |
Classification.Door | El ancla representa una puerta. |
Classification.Other | El ancla no se ha identificado como ninguno de los tipos anteriores. Véase: classificationString |
La siguiente tabla muestra la correspondencia entre el tipo de clasificación en Qt Quick 3D Xr, OpenXR y VisionOS. Si el tipo de clasificación del sistema no se encuentra entre los tipos definidos, el «Tipo» se establece en « Other », y el tipo del sistema se indica mediante la propiedad « classificationString ».
Nota: La cadena de clasificación también puede ser « Other ».
| Tipo | OpenXR | VisionOS | Descripción |
|---|---|---|---|
| Desconocido | - | - | La etiqueta no se ha establecido ni identificado. |
| Pared | WALL_FACE | Pared | El ancla representa una pared. |
| Techo | TECHO | Techo | El ancla representa un techo. |
| Suelo | SUELO | Suelo | El ancla representa un suelo. |
| Tabla | TABLA | Tabla | El enlace representa una mesa. |
| Asiento | SOFÁ | Asiento | El icono representa un asiento. |
| Ventana | MARCO_DE_VENTANA | Ventana | El ancla representa una ventana. |
| Puerta | MARCO_DE_PUERTA | Puerta | El ancla representa una puerta. |
| Otros | - | - | El ancla representa otra cosa. Véase: classificationString |
classification : enumeration [read-only]
El tipo de clasificación del ancla espacial.
Esta propiedad devuelve el valor de la enumeración « classification type » correspondiente a este ancla (por ejemplo, «Table » o « Floor »), que describe la finalidad o el contexto del ancla.
Nota: Es posible queel tipo de clasificación proporcionado por el sistema no se encuentre en el conjunto de etiquetas definidas por la enumeración Classification; en tal caso, el tipo se establecerá en Other y la propiedad classificationString contendrá la etiqueta original.
Véase también classificationString.
classificationString : string [read-only]
El tipo de clasificación del anclaje espacial, expresado como cadena de caracteres.
Esta propiedad devuelve el tipo de clasificación como una cadena si existe. Si el tipo de clasificación no se encuentra en el conjunto de tipos definidos por las enumeraciones de Classification, la etiqueta se establece en « Other », y esta propiedad puede utilizarse para acceder al tipo tal y como lo ha indicado el sistema.
Nota: Esta cadena puede estar vacía o cambiar, dependiendo del sistema y de cómo se clasifique el ancla.
Véase también classification.
extent2D : vector2d [read-only]
La extensión bidimensional del ancla espacial.
Esta propiedad contiene el tamaño del ancla espacial en dos dimensiones (anchura y altura) dentro del plano X/Z. Es válida cuando has2DBounds es true.
Véase también « has2DBounds » y « offset2D ».
extent3D : vector3d [read-only]
La extensión tridimensional del ancla espacial.
Esta propiedad especifica el volumen del ancla espacial en tres dimensiones (anchura, altura y profundidad). Es válida cuando has3DBounds es true.
Véase también « offset3D » y « has3DBounds ».
has2DBounds : bool [read-only]
Indica si el ancla espacial tiene límites bidimensionales.
Esta propiedad toma el val true si el ancla espacial tiene límites en 2D, tal y como se describe en offset2D y extent2D, lo que indica que representa una superficie plana (por ejemplo, un suelo o una pared).
En caso contrario, devuelve «false».
Véase también offset2D, extent2D y has3DBounds.
has3DBounds : bool [read-only]
Indica si el ancla espacial tiene límites 3D.
Esta propiedad devuelve « true » si el ancla espacial tiene límites en 3D, lo que indica que representa un volumen (por ejemplo, una mesa o un armario). Los límites se describen mediante « offset3D » y « extent3D ».
En caso contrario, devuelve false.
Véase también offset3D, extent3D y has2DBounds.
identifier : string [read-only]
Un identificador único para este ancla espacial.
Esta propiedad contiene un identificador único asociado al ancla espacial. Se trata del mismo identificador al que hace referencia un « XrSpatialAnchorListModel ».
offset2D : vector2d [read-only]
El desplazamiento en 2D del ancla espacial.
Esta propiedad contiene el desplazamiento de los límites del ancla dentro del plano X/Z. Es válida cuando has2DBounds es true.
Véase también has2DBounds y extent2D.
offset3D : vector3d [read-only]
El desplazamiento 3D del ancla espacial.
Esta propiedad proporciona el desplazamiento en 3D de los límites del ancla (en metros) respecto a la posición del ancla position.
Véanse también «offset3D» y « has3DBounds ».
position : vector3d [read-only]
La posición del ancla espacial.
Esta propiedad devuelve la posición 3D (en metros) del origen del ancla espacial dentro del sistema de coordenadas de la sesión.
rotation : quaternion [read-only]
La orientación del ancla espacial.
Esta propiedad proporciona la rotación del ancla espacial (como un cuaternión).
© 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.