Configuración del proyecto de Unity

En esta guía, se detallan las versiones recomendadas del editor, la configuración de gráficos, la configuración de URP y la configuración del proyecto de Android cuando se desarrolla una aplicación de Unity para Android XR.

Requisitos previos

Para desarrollar con Unity, deberás descargar e instalar Unity Hub.

Instala la versión 6000.0.23f1 o una posterior de Unity Editor y Android Build Support, que incluye lo siguiente:

  • OpenJDK
  • SDK de Android
  • Herramientas del NDK de Android

Selecciona un motor de renderización

Te recomendamos que uses la API de gráficos de Vulkan para renderizar apps de Android XR. Para seleccionar Vulkan como tu API de gráficos, sigue estos pasos:

  1. En Unity, ve a Edit > Project Settings > Player.
  2. Selecciona la pestaña Android y navega a Other Settings > Rendering.
  3. Si la API de Auto Graphics está habilitada, inhabilita este parámetro de configuración para mostrar la sección APIs de gráficos.
  4. En la sección APIs de gráficos, selecciona el botón Agregar (+) y elige Vulkan en el menú desplegable.

    Ejemplo que muestra cómo cambiar la configuración de la API de gráficos en la IU

  5. Vuelve a ordenar las APIs de gráficos con los identificadores (=) para que Vulkan aparezca primero.

  6. De manera opcional, selecciona cualquier otra API de gráficos y haz clic en el botón Quitar (-) para quitarlas.

Canalización universal de renderizaciones

Android XR es compatible con la canalización de renderización universal (URP). Si planeas usar el modo de transferencia, debes actualizar la configuración predeterminada de la URP para obtener el mejor rendimiento de transferencia en Android XR.

En la siguiente tabla, se incluye una lista de la configuración de URP recomendada de Unity, que se explica con más detalle en las siguientes secciones.

Configuración

Ubicación

Valor recomendado

HDR

Recurso de la canalización de renderizaciones universal

Inhabilitado

Posprocesamiento

Datos del renderizador universal

Inhabilitado

Configuración de recursos de la canalización de renderizaciones universal

Sigue estos pasos para optimizar tu recurso de canalización de renderización universal para Android XR:

  1. Busca el Recurso de canalización de renderización universal de tu proyecto. Una forma de hacerlo es escribir t:UniversalRenderPipelineAsset en la barra de búsqueda de la ventana Project.

  2. En el encabezado Calidad, inhabilita HDR.

    Recurso de la canalización de renderización universal que se muestra con la configuración recomendada

Configuración de datos del renderizador universal

Sigue estos pasos para optimizar tus datos de renderizador universal para Android XR:

  1. Busca el Recurso de datos del renderizador universal de tu proyecto. Una forma de hacerlo es escribir t:UniversalRendererData en la barra de búsqueda de la ventana Project.

  2. En Inspector, en el encabezado Post-processing, desmarca Enabled.

    Datos del renderizador universal que se muestran con la configuración recomendada

Nivel mínimo de API de Android

Establece tu proyecto en un nivel de API mínimo de 24, que es obligatorio para el cargador de OpenXR. De lo contrario, es posible que tus compilaciones fallen.

Completa estos pasos para establecer el nivel de API de Android mínimo.

  1. Ve a Editar > Configuración del proyecto > Jugador.
  2. Selecciona la pestaña Android y abre Otros parámetros de configuración.
  3. En la sección Identification, en Minimum API level, selecciona 24 o una versión superior.

Punto de entrada de la aplicación

Establece la siguiente configuración para el punto de entrada de la aplicación:

  1. Ve a Editar > Configuración del proyecto > Jugador.
  2. Selecciona la pestaña Android y abre Otros parámetros de configuración.
  3. En la sección Punto de entrada de la aplicación, asegúrate de que esté marcada la opción GameActivity y que no esté marcada la opción Activity.

Ventanas emergentes

La mayoría de las apps para Android XR requieren ventanas de tamaño variable, ya que son necesarias para renderizar ventanas emergentes, como solicitudes de permisos del sistema.

Sigue estos pasos para asegurarte de que las ventanas emergentes se rendericen correctamente.

  1. Ve a Editar > Configuración del proyecto > Jugador.
  2. Selecciona la pestaña Android y habilita Resizeable Activity.

Consulta también