Настройка проекта Unity

В этом руководстве подробно описаны рекомендуемые версии редактора, графические настройки, настройки URP и настройки проекта Android при разработке приложения Unity для Android XR.

Предпосылки

Для разработки с помощью Unity вам потребуется загрузить и установить Unity Hub .

Установите версию 6000.0.23f1 редактора Unity и Android Build Support, которая включает в себя:

  • OpenJDK
  • Android-SDK-комплект
  • Инструменты Android NDK

Выберите движок рендеринга

Мы рекомендуем использовать Vulkan Graphics API для рендеринга приложений Android XR. Чтобы выбрать Vulkan в качестве вашего Graphics API, выполните следующие действия:

  1. В Unity перейдите в меню «Правка» > «Настройки проекта» > «Проигрыватель» .
  2. Выберите вкладку Android и перейдите в Другие настройки > Рендеринг .
  3. Если включен Auto Graphics API , отключите этот параметр, чтобы открыть раздел Graphics API .
  4. В разделе «Графические API» нажмите кнопку «Добавить» (+) и выберите Vulkan из раскрывающегося списка.

    Пример, показывающий, как изменить настройки графического API в пользовательском интерфейсе

  5. Измените порядок графических API с помощью маркеров (=) так, чтобы Vulkan оказался первым в списке.

  6. При желании выберите любые другие графические API и нажмите кнопку Удалить (-), чтобы удалить их.

Универсальный конвейер рендеринга

Android XR совместим с Universal Render Pipeline (URP). Если вы планируете использовать passthrough, вам следует обновить настройки URP по умолчанию для лучшей производительности passthrough на Android XR.

В следующей таблице приведен список рекомендуемых настроек URP Unity, которые более подробно описаны в следующих разделах.

Параметр

Расположение

Рекомендуемое значение

HDR

Универсальный актив конвейера рендеринга

Неполноценный

Постобработка

Универсальные данные рендерера

Неполноценный

Настройки ресурсов Universal Render Pipeline

Чтобы оптимизировать актив Universal Render Pipeline для Android XR, выполните следующие действия:

  1. Найдите Universal Render Pipeline Asset вашего проекта. Один из способов сделать это — ввести t:UniversalRenderPipelineAsset в строку поиска окна проекта .

  2. В разделе «Качество» отключите HDR .

    Актив Universal Render Pipeline показан с рекомендуемыми настройками

Настройки данных универсального рендерера

Чтобы оптимизировать данные Universal Renderer для Android XR, выполните следующие действия:

  1. Найдите Universal Renderer Data Asset вашего проекта. Один из способов сделать это — ввести t:UniversalRendererData в строку поиска окна проекта .

  2. В Инспекторе под заголовком Постобработка снимите флажок Включено .

    Данные Universal Renderer показаны с рекомендуемыми настройками

Минимальный уровень API Android

Установите для своего проекта минимальный уровень API 24, который требуется для OpenXR Loader. В противном случае ваши сборки могут завершиться неудачей.

Выполните следующие действия, чтобы установить минимальный уровень API Android.

  1. Перейдите в меню Правка > Настройки проекта > Плеер .
  2. Выберите вкладку Android и откройте Другие настройки .
  3. В разделе «Идентификация» для параметра «Минимальный уровень API» выберите значение 24 или выше.

Точка входа приложения

Настройте следующие параметры для точки входа приложения:

  1. Перейдите в меню Правка > Настройки проекта > Плеер .
  2. Выберите вкладку Android и откройте Другие настройки .
  3. В разделе «Конфигурация» убедитесь, что в поле «Точка входа в приложение» установлен флажок GameActivity , а флажок Activity снят.

Всплывающие окна

Большинству приложений Android XR требуются окна с изменяемым размером, поскольку они необходимы для отображения всплывающих окон, таких как запросы на системные разрешения.

Чтобы обеспечить корректное отображение всплывающих окон, выполните следующие действия.

  1. Перейдите в меню Правка > Настройки проекта > Плеер .
  2. Выберите вкладку Android и откройте «Разрешение и представление».
  3. В разделе «Разрешение» включите функцию «Изменяемая активность» .

Смотрите также


OpenXR™ и логотип OpenXR являются товарными знаками компании Khronos Group Inc. и зарегистрированы в качестве товарного знака в Китае, Европейском Союзе, Японии и Великобритании.