Configura la vista previa directa para Unreal Engine

Dispositivos de realidad extendida correspondientes
Esta guía te ayuda a crear experiencias para estos tipos de dispositivos de realidad extendida.
Más información sobre los tipos de dispositivos de realidad extendida →
Visores de realidad extendida
Lentes de realidad extendida con cable
Más información sobre los tipos de dispositivos de realidad extendida →

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 la ventana gráfica visual directamente a tu dispositivo Android XR físico y transmite las extensiones OpenXR compatibles a la máquina anfitrión en tiempo real.

Sigue esta guía para configurar la vista previa directa para tu proyecto en Unreal Engine.

Requisitos previos

Antes de comenzar, asegúrate de que tu entorno de desarrollo cumpla con los siguientes requisitos:

  • 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 anfitrión para la vista previa directa.

  • Hardware:

    • Usa una máquina anfitrión que ejecute Windows 11.
    • Usa una tarjeta gráfica moderna con compatibilidad con Vulkan Video Encoding.

Configura los complementos de Android XR

Configura Unreal Engine con los complementos de Android XR necesarios:

  1. 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 los mismos pasos.

  2. Para cada proyecto, asegúrate de que tenga un vínculo simbólico a la carpeta de complementos del proveedor.

Define la configuración del proyecto

Configura los parámetros de configuración del proyecto para la transmisión de vista previa directa:

  1. Navega a Project Settings > Platforms > Windows.
  2. Para RHI a Vulkan.
  3. Navega a Edit > Plugins.
  4. Habilita el complemento AndroidXRStreaming.
  5. Navega a Edit > Project Settings > Description.
  6. Habilita Start In VR.

Habilita el entorno de ejecución de transmisión

Ahora que el proyecto tiene habilitado el complemento AndroidXRStreaming, verifica si está presente el entorno de ejecución de transmisión de Android XR:

  1. Ve a Project Settings > Plugins > AndroidXRStreaming.

  2. Haz clic en Enable AndroidXR Streaming.

    Habilita el entorno de ejecución de transmisión de Android XR

  3. 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:

  1. Ve a Project Settings > Plugins.

  2. En la sección AndroidXRStreamingClient, revisa cada una de las siguientes opciones y habilítalas o inhabilítalas para que coincidan con lo que necesitas para tu proyecto:

    • Auto Start Client On Preview: Cuando está habilitada, 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 está habilitada, finaliza el cliente de vista previa cuando se detiene la vista previa de RV del editor.
    • Auto Select Compatible Device: Cuando está habilitada, selecciona automáticamente el primer dispositivo compatible que está conectado a la máquina cuando se buscan dispositivos.
    • Mostrar diálogos de error: Cuando está habilitada, 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 muestra los compatibles (determinados por la presencia de la app cliente de vista previa directa en Android XR Engine Hub).

Inicia la vista previa directa

Inicia la vista previa directa para transmitir directamente desde Unreal Engine:

  1. Conecta tu dispositivo Android XR a tu máquina anfitrión con un cable USB-C de alta calidad.

  2. 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 juegos.

  3. En Unreal Editor, haz clic en Play level in VR. No uses la opción habitual Play in Editor cuando inicies la vista previa directa.