XrSpatialAnchor QML Type
Rastrea una ubicación u objeto específico en el espacio real. Más...
| Import Statement: | import QtQuick3D.Xr |
| Since: | Qt 6.8 |
| Inherits: |
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 rastrea una ubicación u objeto específicos en el espacio real. Proporciona información sobre la posición, rotación, clasificación y límites del ancla.
Se accede a las anclas espaciales a través de XrSpatialAnchorListModel.
Nota: El sistema proporciona objetos Anchor. No pueden crearse en QML.
Consulte el ejemplo de anclajes espaciales deQt Quick 3D - XR para saber cómo utilizar este tipo.
Notas sobre la plataforma
Dispositivos Meta Quest
Esta API hace uso de las APIs de Escenas y Anclajes Espaciales de Meta Quest. Debe añadir los siguientes permisos al archivo AndroidManifest.xml de su aplicación:
<uses-permission android:name="com.oculus.permission.USE_ANCHOR_API"/> <uses-permission android:name="com.oculus.permission.USE_SCENE"/>
Nota: Es necesario configurar manualmente un Espacio antes de ejecutar una app, o los anclajes no estarán disponibles.
Documentación de propiedades
Classification : enumeration [read-only]
Clasificación del anclaje espacial.
El enum Clasificación proporciona un conjunto de tipos de categorías predefinidas que describen el propósito o el contexto de un ancla espacial.
| Constante | Descripción |
|---|---|
Classification.Unknown | La etiqueta no se ha establecido o identificado. |
Classification.Wall | El anclaje representa una pared. |
Classification.Ceiling | El ancla representa un techo. |
Classification.Floor | El anclaje representa un suelo. |
Classification.Table | El anclaje representa una mesa. |
Classification.Seat | El anclaje representa un asiento. |
Classification.Window | El ancla representa una ventana. |
Classification.Door | El anclaje representa una puerta. |
Classification.Other | El ancla no se identificó como ninguno de los tipos anteriores. Ver: classificationString |
La siguiente tabla muestra el mapeo entre el tipo de clasificación en Qt Quick 3D Xr, OpenXR, y VisionOS. Si el tipo de clasificación del sistema queda fuera de los tipos definidos, entonces el Tipo se establece en Other, y el tipo del sistema se proporciona mediante la propiedad classificationString.
Nota: La cadena de clasificación también puede ser Other.
| Tipo | OpenXR | VisionOS | Descripción |
|---|---|---|---|
| Desconocido | - | - | La etiqueta no ha sido fijada o identificada. |
| Pared | CARA_PARED | Pared | El anclaje representa una pared. |
| Techo | TECHO | Techo | El ancla representa un techo. |
| Suelo | SUELO | Suelo | El ancla representa un suelo. |
| Mesa | MESA | Mesa | El ancla representa una mesa. |
| Asiento | SILLÓN | Asiento | El ancla representa un asiento. |
| Ventana | MARCO_VENTANA | Ventana | El ancla representa una ventana. |
| Puerta | MARCO_PUERTA | Puerta | El ancla representa una puerta. |
| Otros | - | - | El ancla representa otra cosa. Ver: classificationString |
classification : enumeration [read-only]
Tipo de clasificación del anclaje espacial.
Esta propiedad devuelve el classification type para esta ancla (por ejemplo,Table o Floor) que describe el propósito o el contexto del ancla.
Nota: El tipo de clasificación procedente del sistema puede no estar en el conjunto de etiquetas definidas por el enum Classification, en cuyo 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 ancla espacial como cadena.
Esta propiedad devuelve el tipo de clasificación como cadena si existe. Si el tipo de clasificación no está en el conjunto de tipos definidos por los enums de Classification, la etiqueta se establece en Other, y esta propiedad puede utilizarse para acceder al tipo tal y como fue informado por 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 2D 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 3D 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 2D.
Esta propiedad es true si el ancla espacial tiene límites 2D, descritos por 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 3D, lo que indica que representa un volumen (por ejemplo, una mesa o un armario). Los límites se describen en offset3D y extent3D.
En caso contrario, devuelve false.
Véase también offset3D, extent3D y has2DBounds.
identifier : string [read-only]
Identificador único de esta ancla espacial.
Esta propiedad contiene un identificador único asociado al ancla espacial. Es el mismo identificador al que hace referencia XrSpatialAnchorListModel.
offset2D : vector2d [read-only]
Desplazamiento 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]
Desplazamiento 3D del ancla espacial.
Esta propiedad proporciona el desplazamiento 3D de los límites del ancla (en metros) desde el ancla de position.
Véase también offset3D y has3DBounds.
position : vector3d [read-only]
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.
