Qt Quick Ejemplo sencillo de 3D - XR

Muestra cómo configurar una escena sencilla de realidad virtual con Qt Quick 3D XR.

Escena de realidad virtual con el texto «Qt 6» en realidad virtual y tres cubos de colores

Este ejemplo ofrece una visión general introductoria de las características básicas de Qt Quick 3D XR.

La principal diferencia a la hora de escribir una aplicación XR es que el elemento raíz de nuestro archivo main.qml es un « XrView » en lugar de una «Window» con un « View3D »:

import QtQuick3D
import QtQuick3D.Xr

XrView {
    id: xrView
    XrErrorDialog { id: err }
    onInitializeFailed: (errorString) => err.run("XRView", errorString)
    referenceSpace: XrView.ReferenceSpaceLocalFloor

El ` XrView ` contiene la escena 3D, al igual que un ` View3D`. En este ejemplo añadimos un ` XrErrorDialog ` que mostrará un cuadro de diálogo de error si se produce un error al inicializar las gafas de realidad virtual al transmitir desde un ordenador de sobremesa. También especificamos que el sistema de referencia de esta aplicación se mide desde el suelo de la habitación en la que se encuentra el usuario. Es decir, el suelo estará en ` y = 0`.

El origen del sistema de referencia viene definido por el XrOrigin:

    xrOrigin: theOrigin
    XrOrigin {
        id: theOrigin

        XrController {
            controller: XrController.LeftController
            poseSpace: XrController.AimPose
            CubeModel { color: "blue" }
        }

        XrController {
            controller: XrController.RightController
            poseSpace: XrController.AimPose
            CubeModel { color: "red" }
        }
    }

En este ejemplo añadimos dos elementos « XrController », uno para cada mano. Estos elementos realizarán el seguimiento de la posición y la orientación de las manos del usuario. Dado que « XrController » es un « Node », cualquier elemento secundario seguirá automáticamente los movimientos de las manos. En este caso, utilizamos un modelo sencillo de cubo para visualizar la posición del controlador.

El resto de main.qml es una escena 3D normal de Qt Quick.

Proyecto de ejemplo en code.qt.io

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