Parte: 13 — VR, AR y experiencias inmersivas · Fuente: Síntesis de la Parte 13 sobre documentación de XR en Godot 4 ⏱️ Duración estimada: 120 min · Nivel: Avanzado
Es hora de integrar todo lo aprendido en la Parte 13 en una experiencia jugable y coherente. Elegirás una de dos rutas: una experiencia VR mínima —una sala a escala real con locomoción por teleport, agarrar objetos, una UI espacial, audio 3D y háptica, corriendo al framerate objetivo del visor— o una experiencia AR mínima —colocar objetos anclados sobre planos detectados con ARCore/ARKit. Ambas ponen a prueba lo esencial: presencia, interacción, rendimiento y feedback multimodal.
Trabajarás con una especificación clara, un checklist y una definition of done para saber cuándo la experiencia está realmente terminada, no solo "funcionando a medias". El foco es integrar bien lo existente, no añadir features nuevas: una experiencia pequeña pero pulida vale más que una grande y mareante.
Al finalizar, el alumno podrá:
| # | Tema | Por qué importa |
|---|---|---|
| 1 | Elección de ruta VR o AR | Cada una integra un subconjunto distinto de la parte. |
| 2 | Especificación de la experiencia | Define el alcance y evita el sobrealcance. |
| 3 | Integración de sistemas | El valor está en que todo funcione junto. |
| 4 | Locomoción por teleport (VR) | Movimiento cómodo sin marear. |
| 5 | Agarre y UI espacial (VR) | Interacción natural con el entorno. |
| 6 | Colocación anclada (AR) | Objetos fijos y creíbles sobre el mundo. |
| 7 | Rendimiento sostenido | Sin framerate estable no hay confort. |
| 8 | Checklist y definition of done | Distinguen "termina" de "casi termina". |
Reúne lo construido en las clases 231–238: el proyecto VR con OpenXR (o el proyecto AR con plugin de la clase 236), el renderer Mobile para standalone, los scripts de locomoción, agarre, audio 3D y háptica. Necesitas el hardware real: un visor VR (Quest u otro) para la ruta VR, o un móvil con ARCore/ARKit para la ruta AR. Prepara un lector de framerate en pantalla (clase 237) para verificar el rendimiento durante las pruebas.
Referencias: XR en Godot en https://docs.godotengine.org/en/stable/tutorials/xr/index.html y el resto del material de las clases 231–238.
Construiremos y verificaremos la experiencia. Ruta VR como guía principal; la ruta AR se resume al final.
Especifica el alcance (VR): una sala a escala 1:1 con suelo y paredes, tres objetos agarrables sobre una mesa, un panel de UI espacial con un botón, audio ambiente 3D y háptica al agarrar. Nada más: mantén el alcance mínimo.
Monta el XROrigin3D con XRCamera3D, dos XRController3D, el AudioListener3D en la cabeza y el renderer en Mobile. Verifica la altura del jugador (clase 234).
Implementa la locomoción por teleport: apunta con un mando un arco hasta el suelo, y al soltar el gatillo mueve el XROrigin3D a ese punto. El teleport evita el mareo del movimiento continuo:
extends XRController3D # mando de teleport
@export var origin_path: NodePath
@onready var origin: XROrigin3D = get_node(origin_path)
var destino: Vector3
var destino_valido := false
func _process(_delta: float) -> void:
# Un raycast hijo apunta al suelo; aqui solo leemos su impacto.
var rayo := $RayCast3D as RayCast3D
destino_valido = rayo.is_colliding()
if destino_valido:
destino = rayo.get_collision_point()
func _on_boton_teleport(soltado: bool) -> void:
if soltado and destino_valido:
# Movemos el origin, no la camara: el mundo se recoloca alrededor.
origin.global_position = destino
trigger_haptic_pulse("haptic", 0.0, 0.5, 0.05, 0.0)
AudioStreamPlayer3D de "clic" al agarrar:func agarrar(objeto: Node3D, sonido: AudioStreamPlayer3D) -> void:
objeto.reparent(self) # sigue a la mano
sonido.play() # confirmacion sonora
trigger_haptic_pulse("haptic", 0.0, 0.7, 0.08, 0.0) # confirmacion tactil
Añade una UI espacial: un MeshInstance3D con un SubViewport que muestre un Control con un botón. Detecta el rayo del mando sobre el panel y dispara la acción del botón (por ejemplo, reiniciar la escena) con feedback háptico.
Añade audio ambiente 3D (clase 238) y verifica el framerate con el lector en pantalla mientras te mueves e interactúas. Optimiza (clase 237) hasta sostener el objetivo del visor.
Ruta AR (alternativa): reutiliza la app de la clase 236. La especificación mínima es detectar planos horizontales y colocar hasta tres objetos anclados por toque, estables al caminar, con un indicador visual del plano detectado. Verifica en el móvil que las anclas no derivan.
Pasa el checklist y la definition of done (abajo) en el hardware real. Corrige lo que falle antes de dar por terminado.
Checklist de verificación
Definition of done: la experiencia elegida corre en el hardware real, cumple todos los ítems del checklist, sostiene el framerate objetivo sin caídas perceptibles y puede jugarse un par de minutos sin causar molestia física ni errores. Si algún ítem falla, no está terminada.
Entrega una de las dos experiencias completa según su especificación mínima, probada en hardware real y superando el checklist y la definition of done. Documenta qué ruta elegiste, qué sistemas integraste y el framerate medido durante la prueba.
Criterio de aceptación: la experiencia corre en el visor o el móvil, integra los sistemas requeridos (locomoción, agarre, UI, audio y háptica en VR; detección de planos y colocación anclada en AR), sostiene el framerate objetivo y pasa todos los ítems del checklist sin causar mareo ni errores en una sesión de prueba.
| Síntoma / mensaje | Causa y cómo arreglar |
|---|---|
| El teleport marea igual que el movimiento | Añadiste desplazamiento continuo por error. Muévete solo al soltar el gatillo, de golpe. |
| El objeto agarrado no sigue la mano | No lo reparentaste al XRController3D. Usa reparent al mando al agarrar. |
| La UI espacial no responde | El rayo del mando no impacta el panel o falta el SubViewport. Revisa colisión y viewport. |
| Framerate cae al integrar todo | La suma de sistemas supera el presupuesto. Optimiza (clase 237) y mide. |
| Los objetos AR derivan | Tracking pobre. Mejora luz y textura del entorno y limita el número de anclas. |
❓ ¿VR o AR, cuál elijo? La que tu hardware permita probar de verdad. Ambas rutas son válidas; lo importante es integrar y verificar en el dispositivo real.
❓ ¿Puedo ampliar el alcance con más features? El objetivo es integrar y pulir lo existente. Amplía solo si ya cumples la definition of done por completo.
❓ ¿Qué pasa si no llego al framerate objetivo? No está terminado. El rendimiento es parte de la DoD porque sin él la experiencia marea.
❓ ¿Basta con que funcione en el editor? No. XR se valida en hardware real: muchos problemas (tracking, confort, framerate) solo aparecen en el visor o el móvil.
Clase 238 - Audio espacial y hápticos
Clase 240 - Mentalidad de rendimiento: medir antes de optimizar