En esta página

Qt Quick 3D Xr

Imagen de un casco de realidad virtual

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.

© 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.