Qt Quick Ejemplo de teletransporte de forma libre en 3D - XR
Muestra cómo implementar un sistema de desplazamiento sencillo en un entorno 3D X Qt Quick.

Descripción general
Este ejemplo muestra cómo desplazarse a distintos lugares del entorno virtual utilizando un sencillo sistema de teletransporte de forma libre, una forma de movimiento no continuo.
Controles
Para navegar, utiliza el joystick del mando derecho:
- Empuja el joystick hacia delante para apuntar y suéltalo para teletransportarte.
- Mueve el joystick hacia los lados para girar.
Implementación
La lógica de teletransporte se implementa en el componente « FreeformTeleporter ».
FreeformTeleporter {
id: teleporter
view: xrView
originNode: xrOrigin
cameraNode: xrOrigin.camera
beamHandle: xrRightController
rotationTriggerValue: xrRightController.xValue
teleportTriggerValue: xrRightController.yValue
onDoTeleportation: (cameraOriginPosition)=> {
xrOrigin.position = cameraOriginPosition
}
onDoRotation: (cameraOriginRotation, cameraOriginPosition)=> {
xrOrigin.rotation = cameraOriginRotation
xrOrigin.position = cameraOriginPosition
}
}El componente «FreeformTeleporter» tiene las siguientes propiedades que deben configurarse:
QtObject xrViewLa propiedad « xrView » permite acceder a la selección de rayos integrada en « XrView ». Puedes utilizar cualquier objeto que implemente el método « rayPick ». Por ejemplo, un « View3D » puede resultar útil para crear prototipos.
Node originNodeLa propiedad originNode especifica el nodo que manipulará el teletransportador de forma libre. En XR, la locomoción artificial se lleva a cabo moviendo el XrOrigin. Por lo tanto, utilizaremos el xrOrigin de nuestro XrView como originNode.
Node cameraNodeLa propiedad cameraNode proporciona la posición de la cámara. Al girar, define el centro de rotación. Al teletransportarse, define la posición que se situará sobre la ubicación seleccionada. En este ejemplo, utilizamos el XrCamera con seguimiento que creamos anteriormente.
Nota: En XR, la propiedad « XrOrigin » define la relación entre la escena y el espacio de referencia del usuario. Este espacio de referencia suele estar anclado al espacio físico que rodea al usuario. Al cambiar la posición del « XrOrigin », se modificará la forma en que las ubicaciones físicas se asignan a las coordenadas de la escena. El « XrCamera » realiza un seguimiento de la posición de la cabeza del usuario. Cuando el usuario se mueve físicamente, la posición y la orientación del « XrCamera » cambiarán con respecto al « XrOrigin ».
Node beamHandleLa propiedad beamHandle es el nodo que se utiliza como punto de partida del rayo de teletransporte. En este ejemplo, utilizamos el mando derecho como beamHandle.
Véase también «Locomoción» en Qt Quick 3D 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.