En esta página

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:

QtObject

Status: Technology preview

Este tipo se encuentra en fase de vista previa tecnológica y está sujeto a cambios.

Propiedades

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.

ConstanteDescripción
Classification.UnknownLa etiqueta no se ha establecido ni identificado.
Classification.WallEl punto de referencia representa una pared.
Classification.CeilingEl punto de referencia representa un techo.
Classification.FloorEl ancla representa un suelo.
Classification.TableEl marcador representa una mesa.
Classification.SeatEl ancla representa un asiento.
Classification.WindowEl ancla representa una ventana.
Classification.DoorEl ancla representa una puerta.
Classification.OtherEl 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 ».

TipoOpenXRVisionOSDescripción
Desconocido--La etiqueta no se ha establecido ni identificado.
ParedWALL_FACEParedEl ancla representa una pared.
TechoTECHOTechoEl ancla representa un techo.
SueloSUELOSueloEl ancla representa un suelo.
TablaTABLATablaEl enlace representa una mesa.
AsientoSOFÁAsientoEl icono representa un asiento.
VentanaMARCO_DE_VENTANAVentanaEl ancla representa una ventana.
PuertaMARCO_DE_PUERTAPuertaEl 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.