Инструкции

Начало работы с Unity и Android XR

Время на чтение: 6 минут
Посмотреть профиль пользователя Luke Hopkins
Luke Hopkins Инженер по связям с разработчиками, Android

Samsung Galaxy XR уже в продаже, работает на Android XR! Эта запись – часть недели Android XR, в рамках которой мы публикуем записи в блоге, видео, примеры кода и другие материалы, чтобы помочь вам узнать больше об Android XR, а также создать и подготовить приложения для этой платформы.

Сейчас самое время начать разрабатывать приложения с расширенной реальностью. В декабре прошлого года мы анонсировали Android XR – новую платформу Android от Google, созданную на основе открытых стандартов, таких как OpenXR и Vulkan. Благодаря ей разработка XR-приложений стала доступнее, чем когда-либо.


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

openxr_face_tracking2.webp

Мы хотим помочь вам начать работу, независимо от того, есть ли у вас опыт разработки для XR.

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

К концу этого блога вы будете хорошо понимать:

  • Экосистема пакетов
  • Основные шаги по настройке
  • Способы ввода
  • Конфиденциальность и разрешения
  • Слои композиции

Unity для разработки под Android XR

Unity поддерживает кросс-платформенную совместимость, поэтому вы можете создать приложение один раз и развернуть его на Android XR и других XR-устройствах.

Unity предлагает развитую экосистему XR и инструменты. В нем уже есть такие пакеты, как XR Interaction Toolkit, плагин OpenXR, слои композиции XR, XR Hands, обширный магазин ассетов с компонентами и шаблонами для XR, а также инструменты для симуляции и тестирования XR. А поскольку в ноябре прошлого года вышла Unity 6, вы также сможете воспользоваться преимуществами улучшенной производительности Universal Render Pipeline (URP), более эффективной поддержки графики Vulkan и расширенных профилей сборки.

Вот несколько примеров проектов, которые помогут вам понять, что можно сделать:

Базовая настройка: основа для разработки

Требования и установка Unity 6

Для создания приложения вам понадобится Unity 6, так как более ранние версии не поддерживают Android XR. Сначала установите Unity Hub, а затем Unity 6 с модулем Android Build Support, следуя этим инструкциям.

unity6.png

Профили сборки Android XR: упрощение настройки

Профили сборки Unity – это объекты проекта, в которых хранятся настройки и конфигурации для конкретной платформы. Вместо того чтобы вручную задавать 15–20 разных настроек в нескольких меню, вы можете использовать профиль сборки, который сделает это автоматически.
Вы можете создавать собственные профили сборки, но пока мы рекомендуем использовать специальный профиль сборки Android XR, который мы создали.

Чтобы выбрать профиль сборки, в проекте Unity нажмите "Файл > Профиль сборки". Полные инструкции вы найдете на странице Разработка для Android XR.

Если вы внесете изменения, то сможете создать новый профиль сборки и поделиться им с командой. Это позволит обеспечить единообразие сборки.

buildprofiles.png

После этого вы сможете создать и запустить APK для устройств Android XR.

Графический API: почему Vulkan важен

После того как вы настроите проект Unity с профилем сборки Android XR, рекомендуем убедиться, что в качестве графического API выбран Vulkan. Android XR – это платформа, ориентированная на Vulkan. В марте 2025 года мы объявили, что Vulkan стал официальным графическим API для Android. Это современный низкоуровневый графический API, который помогает разработчикам максимально эффективно использовать современные графические процессоры и открывает доступ к таким продвинутым функциям, как трассировка лучей и многопоточность, для создания реалистичной и захватывающей игровой графики.

Эти стандарты обеспечивают наилучшую совместимость с существующими приложениями и упрощают перенос, снижая его стоимость. Кроме того, он позволяет включить расширенные функции Android XR, такие как URP Application Space Warp и фовеальный рендеринг. 

Unity 6 работает с Vulkan автоматически, поэтому при использовании профиля сборки Android XR Unity настроит Vulkan в качестве графического API. Это позволит вам получить доступ ко всем расширенным функциям Android XR без необходимости настраивать их вручную.

Чтобы проверить настройки графического API, выберите Edit (Изменить) > Project Settings (Настройки проекта) > Player (Проигрыватель) > Android tab (Вкладка Android) > Other settings (Другие настройки) > Graphics APIs (Графические API).

graphics-api.png
appentrypoint.png

Общие сведения об экосистеме пакетов

Для Android XR в Unity можно использовать два разных пакета. Первый – с помощью Android XR Extensions для Unity, а второй – с помощью пакета Unity OpenXR: Android XR.

Может показаться, что это одно и то же, но это не так.

Пакет Unity OpenXR: Android XR – это официальный пакет Unity для поддержки Android XR. Она предоставляет большинство функций Android XR, доступных через стандарты OpenXR. Он также позволяет интегрировать AR Foundation для функций смешанной реальности. Основное преимущество использования пакета Unity OpenXR: Android XR заключается в том, что он предлагает унифицированный API для поддержки устройств XR.


Android XR Extensions for Unity – это пакет XR от Google, разработанный специально для создания приложений для устройств Android XR. Он дополняет пакет Unity OpenXR дополнительными функциями, такими как режимы смешивания окружения, создание сетки сцены, отслеживание изображений и отслеживание тела. Однако в этом случае вы сможете разрабатывать приложения только для устройств Android XR.


Выбор зависит от ваших потребностей, но мы рекомендуем Unity OpenXR: Android XR, поскольку он обеспечивает гораздо большую гибкость в отношении устройств, с которыми будет совместимо ваше приложение. Затем, исходя из требований приложения, вы можете добавить Android XR Extensions для Unity.

Как установить пакеты

Чтобы добавить новый пакет, откройте проект в Unity и выберите Window (Окно) > Package Management (Управление пакетами) > Package Manager (Менеджер пакетов).

На вкладке Unity Registry (Реестр Unity) можно установить следующие пакеты:

packagemanager.png

Вы можете установить пакет Android XR для Unity через GitHub. Для этого нажмите на значок плюса, выберите "Установить пакет из URL-адреса git" и введите https://github.com/android/android-xr-unity-package.git.

packagemanager2.png

Обязательные функции OpenXR

Теперь, когда вы установили нужные пакеты, давайте включим некоторые основные функции, чтобы запустить проект.

Вы можете включить OpenXR для Android: Edit (Изменить) > Project Settings (Настройки проекта) > XR Plugin Management (Управление плагинами XR) > Android > OpenXR.

xrpluginmgmt.png

Теперь нужно включить поддержку Android XR. Другие функции OpenXR мы рассмотрим по мере необходимости. Пока нам нужно только включить поддержку Android XR.

Ввод

Android XR поддерживает ввод с помощью рук, голоса, отслеживания взгляда, клавиатуры и контроллеров. Рекомендуем установить XR Interaction Toolkit и XR Hands, так как они содержат лучшие префабы для начала работы. В этих префабах есть все необходимое для поддержки рук и контроллеров в приложении.

xrinteractiontoolkit.png

После установки XR Hands и XR Interaction Toolkit рекомендуем импортировать Starter Assets и Hands Interaction Demo. Затем включите профили Hand Interaction и Khronos Simple Controller, а также функции подсистемы отслеживания рук и Meta Hand Tracking Aim.

Чтобы изменить эти настройки, выберите Edit (Изменить) > Project Settings (Настройки проекта) > XR Plug-in Management (Управление плагинами XR) > OpenXR.

profiles.png

Мы также рекомендуем использовать префаб Unity XR Origin, который представляет положение и ориентацию пользователя в пространстве XR. Он содержит компоненты установки камеры и отслеживания, необходимые для рендеринга XR-контента с правильной точки обзора.

Проще всего добавить этот префаб, импортировав его из демоверсии интеграции рук, которую мы импортировали ранее. Его можно найти здесь: Hands Integration Toolkit > Hand Interaction > Prefabs > XR Origin.

prefabs.png

Рекомендуем использовать этот префаб вместо XR Origin в игровых объектах, поскольку в нем есть XR Input Modality Manager, который автоматически переключается между руками пользователя и контроллерами. Это позволит вам легко переключаться между руками и контроллерами.

Конфиденциальность и разрешения: как завоевать доверие пользователей

В любом случае вам потребуется запрашивать у пользователей динамические разрешения. Это связано с тем, что распознавание сцены, отслеживание взгляда, лица и рук предоставляют доступ к данным, которые могут быть более конфиденциальными для пользователя.

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

Например, если вы используете пакет XR Hands для пользовательских жестов, вам нужно будет запросить разрешение на отслеживание рук (см. ниже), поскольку этому пакету требуется отслеживать много информации о руках пользователя. Это включает в себя отслеживание положения суставов рук, а также угловых и линейных скоростей.

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

const string k_Permission = "android.permission.HAND_TRACKING";

#if UNITY_ANDROID
void Start()
{
    if (!Permission.HasUserAuthorizedPermission(k_Permission))
    {
        var callbacks = new PermissionCallbacks();
        callbacks.PermissionDenied += OnPermissionDenied;
        callbacks.PermissionGranted += OnPermissionGranted;
        
        Permission.RequestUserPermission(k_Permission, callbacks);
    }
}

void OnPermissionDenied(string permission)
{
    // handle denied permission
}


void OnPermissionGranted(string permission)
{
    // handle granted permission
}

#endif // UNITY_ANDROID

Как улучшить качество изображения с помощью слоев композиции

Слой композиции – это рекомендуемый способ отрисовки элементов интерфейса. Они позволяют показывать элементы в гораздо более высоком качестве, чем при использовании стандартного конвейера рендеринга Unity, поскольку все отрисовывается непосредственно в компоновщике платформы.

Например, при отображении текста стандартный рендеринг Unity с большей вероятностью приведет к размытию текста, мягким краям и визуальным артефактам. А со слоями композиции текст будет более четким, контуры – более резкими, а общее впечатление – более приятным.


Кроме того, текст, видео, изображения и элементы интерфейса отображаются в гораздо более высоком качестве. Для этого используется встроенная поддержка слоев компоновщика среды выполнения.

Чтобы включить слои композиции, откройте Package Manager, выберите Unity Register и установите XR Composition Layers.

Сборка и запуск

Теперь, когда вы установили пакеты OpenXR, включили функции и настроили префаб для движений рук и головы, вы можете создать сцену и развернуть ее непосредственно на шлеме для тестирования.

Что дальше: расширение навыков

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

Полезные ресурсы

Примеры проектов:

Автор:
Продолжить чтение