Qt Quick 3D Xr

Introducción
La realidad extendida (XR) es un término que engloba la realidad virtual (VR), la realidad aumentada (AR) y la realidad mixta (MR). Estas tecnologías crean experiencias inmersivas que pueden alterar la percepción que tiene el usuario del mundo que le rodea. El módulo 3D Xr de Qt Quick proporciona API para desarrollar aplicaciones de XR con 3D de Qt Quick en una amplia variedad de dispositivos y plataformas.
Diferencia entre las aplicaciones 3D de « Qt Quick » y las aplicaciones 3D de « Qt Quick XR»
El punto de partida
La principal diferencia entre una aplicación de « Qt Quick 3D» y una de « Qt Quick 3D XR», desde el punto de vista del desarrollador, es el punto de entrada a la escena, y es fundamental tener en cuenta las unidades del mundo real y los datos de seguimiento.
En Qt Quick 3D, una aplicación mínima consistiría en una cámara, una luz y un modelo 3D. La posición y el tamaño de estos elementos se definen en el sistema de coordenadas de la escena, que es arbitrario y puede ser definido por el desarrollador para adaptarse a las necesidades de la aplicación.
View3D {
width: 1280
height: 720
PerspectiveCamera {
position: Qt.vector3d(0, 200, 300)
}
DirectionalLight {
}
Node {
id: sceneRoot
Model {
id: model
position: Qt.vector3d(0, -200, 0)
source: "#Cylinder"
materials: [ PrincipledMaterial {
baseColor: "red"
}]
}
}
}En una aplicación de realidad extendida (XR), hay que tener en cuenta las unidades del mundo real y los datos de seguimiento a la hora de definir la escena. La posición y la orientación de la cámara vienen determinadas por las del dispositivo o, en el caso de los visores montados en la cabeza (HMD), por la posición y la orientación de la cabeza del usuario. Las unidades de la escena deben coincidir con las del mundo real. Por ejemplo, lo normal es que una puerta o un escritorio tengan el mismo tamaño en el mundo real que en el mundo virtual.
Nota: El punto de entrada en una aplicación 3D XR de « Qt Quick » no es un ` View3D `, sino el ` XrView`. Además, un ` XrOrigin ` define el origen de la escena, respecto al cual se colocan los elementos rastreados.
XrView {
DirectionalLight {
}
xrOrigin: XrOrigin {
XrController {
id: rightController
controller: XrController.ControllerRight
}
XrController {
id: leftController
controller: XrController.ControllerLeft
}
}
Node {
id: sceneRoot
Model {
id: floor
source: ":meshes/floor.mesh"
materials: [ PrincipledMaterial {
baseColor: "green"
}]
}
Model {
id: table
property real height: 0.7
position: Qt.vector3d(0, height - 2.5, 0)
source: ":meshes/table.mesh"
materials: PrincipledMaterial {
baseColor: "white"
}
}
Model {
id: monitor
source: ":meshes/monitor.mesh"
y: table.height
XrItem {
id: theScreen
y: monitor.yOffset + height
x: -width / 2
width: monitor.width
height: monitor.height
contentItem: ScreenContent {}
}
}
}
}Funciones adicionales de CMake
Como se puede ver en el archivo CmakeLists.txt de todos los ejemplos deQt Quick 3D Xr, es necesario añadir algunas funciones al archivo CMakeLists de nivel superior de tu proyecto.
Para especificar un ` AndroidManifest.xml ` personalizado y asegurarte de que se utilice, añade esta línea al archivo `CMakeLists` de tu proyecto:
if(ANDROID)
set_property(TARGET xr_simple APPEND PROPERTY QT_ANDROID_PACKAGE_SOURCE_DIR ${CMAKE_CURRENT_SOURCE_DIR}/android)
endif()Para obtener más detalles sobre cómo configurar tu ` AndroidManifest.xml`, consulta la sección correspondiente de la página «Introducción a Meta Quest 3 ».
Los cambios en CMakeLists.txt también se aplican a visionOS, donde incluimos el archivo « MacOSXBundleInfo.plist.in »:
if (APPLE AND CMAKE_SYSTEM_NAME STREQUAL "visionOS")
set_target_properties(xr_simple PROPERTIES
MACOSX_BUNDLE_GUI_IDENTIFIER io.qt.xr_simple
MACOSX_BUNDLE_INFO_PLIST ${CMAKE_CURRENT_SOURCE_DIR}/visionos/MacOSXBundleInfo.plist.in
)
endif()¿Qué pasos seguir a partir de aquí?
Echa un vistazo a «Introducción a Meta Quest 3» o «Introducción a Apple Vision Pro» para obtener más información sobre cómo empezar a utilizar tu dispositivo específico. Consulta la página «Plataformas compatibles» para obtener más información sobre las plataformas y los dispositivos compatibles.
Si buscas una API 3D XR específica de Qt Quick, echa un vistazo a « API Reference » o prueba uno de los ejemplos de 3D XR deQt Quick , que muestran cómo se pueden utilizar las API 3D XR de Qt Quick.
Enlaces rápidos
| Plataformas y cadenas de herramientas | Primeros pasos | Referencia de la API |
| Ejemplos | Herramientas e IDE | Desarrollo de aplicaciones XR |
© 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.