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

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