Configura la función Direct Preview para Unity

Dispositivos de realidad extendida correspondientes
Esta guía te ayuda a crear experiencias para estos tipos de dispositivos de realidad extendida.
Visores de realidad extendida
Lentes de realidad extendida con cable

La vista previa directa te permite probar y realizar iteraciones en interacciones complejas directamente dentro del modo de reproducción del editor de Unity 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 Unity.

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 codificación de video de Vulkan.

Revisa los problemas conocidos y las limitaciones

Revisa los siguientes problemas conocidos y limitaciones para saber qué esperar cuando uses la vista previa directa en Unity:

  • Audio: El audio no se transmite al visor. En cambio, se reproduce a través de las bocinas o los auriculares de tu máquina anfitrión.
  • Resolución: Los controles para alterar la resolución son limitados. El sistema solicita {2364, 2880} por ojo.
  • IU/UX: El flujo de conexión del cliente es funcional, pero no está pulido para esta versión inicial.
  • Compatibilidad con extensiones: Si bien se admiten muchas extensiones (como el seguimiento de manos, el seguimiento de la mirada y el seguimiento facial), este es un conjunto limitado en comparación con las compilaciones nativas.

Configura los parámetros de configuración de gráficos

Establece Vulkan como el renderizador predeterminado en Windows que controla la codificación de transmisión de video:

  1. Ve a Edit > Project Settings > Player.
  2. Haz clic en la pestaña Other Settings.
  3. Anula la selección de Auto Graphics API for Windows.
  4. Si aparece Direct3D11 o Direct3D12, selecciona cada uno y haz clic en menos (-).
  5. Agrega Vulkan: Haz clic en más (+) y selecciona Vulkan.

    Cómo usar Vulkan como la API de gráficos para Windows

  6. Reinicia el editor de Unity para aplicar estos cambios.

Configura los parámetros de configuración de administración de complementos de OpenXR

Configura tus complementos de OpenXR para la transmisión:

  1. Ve a Edit > Project Settings > XR Plug-in Management.
  2. Haz clic en la pestaña Windows / Standalone (esta pestaña tiene un ícono de computadora).
  3. En la sección Plug-in Providers, selecciona OpenXR.
  4. En la sección OpenXR Feature Group, selecciona Android XR (Extensions).
  5. Selecciona Android XR Support y Android XR: AR Sessions.

    Esto habilita todas las funciones y dependencias compatibles para la transmisión.

    Habilita varios complementos de OpenXR para admitir la transmisión de Direct Preview

  6. Reinicia el editor de Unity para aplicar estos cambios.

Configura los parámetros de configuración de gráficos y calidad

Configura los siguientes parámetros para garantizar la compatibilidad de la transmisión:

  1. Ve a Edit > Project Settings > XR Plugin Management > OpenXR.
  2. Para cada uno de los siguientes parámetros de configuración, selecciona las siguientes opciones:

    • Render Mode: Multi-pass
    • Depth Submission: Depth 24 bit
    • Foveated Rendering API: Legacy

    Configura los gráficos y la calidad para garantizar la compatibilidad de la transmisión

Realiza la validación del proyecto

Realiza la validación del proyecto para corregir cualquier error de OpenXR en la configuración de tu proyecto:

  1. Ve a Edit > Project Settings > XR Plug-in Management > Project Validation.
  2. Haz clic en la pestaña Standalone.
  3. Haz clic en Fix All para cualquier error con el prefijo [OpenXR].
  4. Haz clic en Fix All para cualquier error con el prefijo [Android XR Streaming].

    Realiza la validación del proyecto para corregir cualquier error de OpenXR en la configuración del proyecto:

Inicia la vista previa directa

Inicia la vista previa directa para transmitir directamente desde Unity:

  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 el editor de Unity, haz clic en Play.

    La transmisión del dispositivo se inicia automáticamente.