En esta página

Qt Quick 3D - Ejemplo de interacción 3D con XR

Muestra cómo manipular objetos 3D con la interacció Qt Quick e 3D XR.

Escena en 3D con letras y formas de colores que flotan en el espacio

Este ejemplo muestra cómo crear componentes que mueven y cambian el tamaño de objetos 3D en una escena. Utiliza la misma estrategia de selección de rayos que el ejemplo xr_input.

Entrada del controlador

En este ejemplo, creamos un componente reutilizable llamado « AimController ». Este componente realiza la selección mediante rayos para elegir un modelo y, opcionalmente, permite al usuario agarrar el modelo seleccionado y moverlo.

AimController define señales que nos permiten implementar interacciones personalizadas:

property Model hoveredObject: null
signal objectPressed(obj: Model, pos: vector3d, direction: vector3d)
signal moved(pos: vector3d, direction: vector3d)
signal released()
signal objectGrabbed(obj: Model)

Gadgets

Definimos un componente abstracto, ` XrGadget`, que tiene dos funciones: ` handleControllerPress ` y ` handleControllerMove`. En C++, estas funciones habrían sido virtuales. Dado que este ejemplo está implementado íntegramente en QML, en su lugar emitimos señales que pueden gestionarse en subcomponentes.

Por ejemplo, TranslateGadget desplaza el objeto controlado a lo largo del eje del gadget en función de la señal onMoved:

onMoved: (pos, dir) => {
    let moveDirection = delta.normalized()
    let mapped_axis = controlledObject.mapDirectionToScene(axisDirection).normalized()
    let dot = mapped_axis.dotProduct(moveDirection)
    let offset = mapped_axis.times(delta.length() * dot)
    controlledObject.position = originalPos.plus(offset)
}

Unirlo todo

Definimos un componente GadgetBox que realiza un seguimiento del objeto seleccionado y muestra un recuadro translúcido alrededor de dicho objeto, además de mostrar gadgets a su alrededor. Al pulsar sobre un objeto seleccionado, la señal GadgetBox alternará entre los tres tipos diferentes de gadgets (traslación, rotación y cambio de tamaño).

En main.qml reaccionamos a las señales de AimController y llamamos a las funciones de GadgetBox:

AimController {
    id: rightAim
    controller: XrController.RightController
    view: xrView
    enableVirtualMouse: true
    enableThumbstickMove: thumbCheckBox.checked

    onObjectPressed: (obj, pos, dir) => {
        gadgetBox.handlePress(obj, pos, dir)
    }
    onHoveredObjectChanged: {
        gadgetBox.handleHover(hoveredObject)
        hapticFeedback.handleHover(hoveredObject)
    }
    onMoved: (pos, dir) => {
        gadgetBox.handleMove(pos, dir)
    }
    onReleased: {
        gadgetBox.handleRelease()
    }
    onObjectGrabbed: (obj) => {
        if (!grabCheckBox.checked)
            return
        const gadget = obj as XrGadget
        if (!gadget)
            startGrab(obj)
        else if (gadget.grabbable)
            startGrab(gadget.controlledObject)
    }
    Model {
        source: "#Cylinder"
        scale: "0.05, 0.1, 0.05"
        z: 5
        eulerRotation.x: 90
        materials: PrincipledMaterial {
            baseColor: "black"
        }
    }
    xrCursor: cursor
}

También proporcionamos retroalimentación háptica cuando cambia el objeto o elemento sobre el que se pasa el cursor:

XrHapticFeedback {
    id: hapticFeedback
    controller: XrHapticFeedback.RightController
    hapticEffect: XrSimpleHapticEffect {
        amplitude: 0.5
        duration: 10
        frequency: 200
    }
    property Model prevObj: null
    function handleHover(obj: Model) {
        if (obj && obj !== prevObj)
            start()
        prevObj = obj
    }
}

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.