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

Применимые устройства XR

Данное руководство поможет вам создавать приложения для устройств XR такого типа.

Узнайте о типах устройств XR →

XR-гарнитуры

Проводные XR-очки

Узнайте о типах устройств XR →

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

Предварительные требования

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

Установите версию 6000.0.58f2 или выше редактора Unity и поддержки сборки Android, которая включает в себя:

• OpenJDK
• Android SDK
• Инструменты Android NDK

Выберите механизм рендеринга

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

1. В Unity перейдите в меню Edit > Project Settings > Player .
2. Выберите вкладку Android и перейдите в раздел «Другие настройки» > «Рендеринг» .
3. Если функция автоматического выбора графического API включена, отключите этот параметр, чтобы отобразить раздел «Графические API» .

4. В разделе «Графические API» нажмите кнопку «Добавить» (+) и выберите Vulkan из выпадающего списка.

   

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

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

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

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

Примечание: Для существующих проектов, содержащих ресурсы, созданные для встроенного конвейера рендеринга (URP), следует использовать конвертер конвейера рендеринга (Render Pipeline Converter) для преобразования этих ресурсов в соответствии с требованиями URP.

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

Параметр	Расположение	Рекомендуемое значение
HDR	Универсальный ресурс конвейера рендеринга	Неполноценный
Постобработка	Универсальные данные рендерера	Неполноценный

Примечание: Vulkan необходим, если вы используете URP. Мы рекомендуем использовать Vulkan в качестве графического API для Android XR, поскольку новые графические функции поддерживаются только с этим API.

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

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

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

   Примечание: Если ваш проект не содержит ресурс Universal Render Pipeline, обратитесь к разделу «Установка Universal Render Pipeline в существующий проект» в документации URP.

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

   

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

Выполните следующие шаги, чтобы оптимизировать данные универсального рендерера для Android XR:

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

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

   

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

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

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

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

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

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

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

Диалоги

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

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

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

См. также

• Unity Android XR: OpenXR
• Импорт расширений Android XR для Unity

---

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