La vista previa directa te permite probar y realizar iteraciones en interacciones complejas directamente en Unreal Editor con datos en vivo del dispositivo Android XR. Con la vista previa directa, la máquina anfitrión renderiza y depura el contenido, transmite el viewport visual directamente a tu dispositivo Android XR físico y transmite las extensiones de OpenXR compatibles de vuelta al host en tiempo real.
Sigue esta guía para configurar la vista previa directa en tu proyecto de Unreal Engine.
Requisitos previos
Antes de comenzar, asegúrate de que tu entorno de desarrollo cumpla con los siguientes requisitos:
- Versión de Unreal Engine: Unreal Engine 5.6.x o 5.8.x.
- Configuración del proyecto: Completa todos los pasos de la guía de configuración del proyecto de Unreal Engine.
- Android XR Engine Hub: Completa todos los pasos de la sección de introducción de la guía de Android XR Engine Hub para instalar y configurar tu máquina host para la vista previa directa.
Hardware:
- Usa una máquina host que ejecute Windows 11.
- Usa una tarjeta gráfica moderna que admita la codificación de video de Vulkan.
Configura los complementos de Android XR
Configura Unreal Engine con los complementos de Android XR necesarios:
Sigue los pasos de la guía de inicio rápido de las extensiones de Android XR para Unreal Engine.
Más adelante, si creas un proyecto nuevo o abres uno que no hayas usado con la vista previa directa, vuelve a seguir esos mismos pasos.
Para cada proyecto, asegúrate de que tenga un symlink a la carpeta de complementos del proveedor.
Define la configuración del proyecto
Establece la configuración del proyecto para la transmisión de Direct Preview:
- Navega a Configuración del proyecto > Platforms > Windows.
- De RHI a Vulkan
- Navega a Edit > Plugins.
- Habilita el complemento AndroidXRStreaming.
- Navega a Edit > Configuración del proyecto > Description.
- Habilita Iniciar en RV.
Habilita el entorno de ejecución de transmisión
Ahora que el proyecto tiene habilitado el complemento AndroidXRStreaming, verifica si el entorno de ejecución de Android XR Streaming está presente:
- Ve a Project Settings > Plugins > AndroidXRStreaming.
Haz clic en Enable AndroidXR Streaming.
Reinicia Unreal Engine para aplicar estos cambios.
Configura el cliente de transmisión
Configura el cliente de transmisión con diferentes opciones para tu proyecto:
- Ve a Project Settings > Plugins.
En la sección AndroidXRStreamingClient, revisa cada una de las siguientes opciones y habilítalas o inhabilítalas según lo que necesites para tu proyecto:
- Auto Start Client On Preview: Cuando se habilita, inicia la app cliente de vista previa en cualquier dispositivo válido seleccionado cuando se hace clic en Start VR Preview desde el editor.
- Auto Stop Client On Preview: Cuando se habilita, finaliza el cliente de vista previa cuando se detiene la vista previa de RV del editor.
- Auto Select Compatible Device: Cuando se habilita, selecciona automáticamente el primer dispositivo compatible que está conectado a la máquina cuando se buscan dispositivos.
- Show Error Dialogs: Cuando se habilita, muestra diálogos de error adicionales (por ejemplo, se muestra un diálogo de error si intentas iniciar una vista previa de RV sin seleccionar un dispositivo cliente). Inhabilita esta opción para ocultar estos diálogos.
- Actualizar: Cuando está habilitado, el botón Actualizar busca dispositivos conectados y enumera los compatibles (determinados por la presencia de la app cliente de vista previa directa en Android XR Engine Hub).
Inicia Direct Preview
Inicia Direct Preview para transmitir directamente desde Unreal Engine:
Conecta tu dispositivo Android XR a la máquina host con un cable USB-C de alta calidad.
Si nunca usaste este dispositivo con la Vista previa directa, conéctalo y configúralo para la Vista previa directa en Android XR Engine Hub antes de iniciar la Vista previa directa a través de tu motor de juego.
En Unreal Editor, haz clic en Play level in VR. No uses la opción habitual Play in Editor cuando inicies Direct Preview.