🎓 Take an interactive course on building and launching apps on the Meta Horizon Store
Интерактивный курс Создание приложения для Магазина Meta Horizon поможет вам создать и запустить свое первое приложение в Магазине Meta Horizon. Узнайте, как с помощью инструментов, рекомендаций и ресурсов сообщества Meta эффективно планировать, разрабатывать и запускать приложения.
В этом руководстве приведены инструкции по настройке Unity для VR-разработки для Meta Quest. Вы узнаете:
как настроить проект Unity 3D, работающий на VR-гарнитурах Meta Quest;
как добавлять VR-взаимодействия в сцену Unity;
как открыть предварительный просмотр приложения на VR-устройстве Meta Quest или на компьютере.
Предварительные требования
Перед началом работы с этим обучающим курсом убедитесь, что соблюдаются перечисленные далее требования.
Требования к оборудованию
Компьютер для разработки под управлением одной из следующих операционных систем:
Windows 10 и более поздние версии (64-разрядные);
macOS 10.10 и более поздние версии (x86 или ARM).
Требования к предпросмотру на гарнитуре
Для запуска приложения Meta Horizon Link, подключающего вашу гарнитуру к компьютеру для разработки, необходимо следующее:
Meta Horizon Link позволяет транслировать на гарнитуру сцены из редактора Unity для тестирования в режиме реального времени, но для этого требуется компьютер Windows. Вы по-прежнему можете собирать и устанавливать приложения на гарнитуру с macOS или Windows, а также проводить тестирование без гарнитуры на обеих платформах с помощью Meta XR Simulator.
Чтобы развернуть приложение на гарнитуре, установите APK на устройство через Центр разработки Meta Quest. Чтобы проводить тестирование без гарнитуры в macOS (только ARM) или Windows, установите Meta XR Simulator.
Unity Hub представляет собой единый центр управления установками, инструментами и проектами Unity. Чтобы установить Unity Hub, выполните следующие действия:
Запустите установщик Unity Hub и дождитесь завершения установки.
Установка редактора Unity
Откройте приложение Unity Hub.
На левой панели навигации, где показываются версии редактора Unity, выберите Installs (Установки).
Нажмите Install Editor (Установить редактор) и выберите версию Unity 6.1 или более позднюю.
На экране Add module (Добавить модуль) выберите пункты Android Build Support (Поддержка разработки на Android) в разделе Platforms (Платформы).
Нажмите Install (Установить).
Шаг 2. Настройте проект Unity 3D
Meta Quest Developer Hub XR project setup
Чтобы сгенерировать проект Unity 3D и Meta XR SDK, вы можете использовать приложение Центра разработки Meta Quest. При выборе этого варианта пропустите этот шаг и переходите сразу к шагу 3: добавление строительных блоков в сцену. Подробные инструкции см. в разделе Создание проектов XR в MQDH.
Добавление SDK Meta XR (расширенная реальность) в аккаунт Unity
На каждой странице нажмите Add to My Assets (Добавить в мои объекты). На следующем изображении показана кнопка для Meta XR Core SDK:
Создание проекта Unity
Чтобы создать проект в Unity Hub, выполните следующие действия:
На левой панели навигации выберите Projects (Проекты) и нажмите New project (Создать проект).
Выберите редактор Unity 6.1 или более поздней версии.
Выберите шаблон Universal 3D (Универсальный шаблон 3D). Если хотите скачать шаблон, нажмите Download template (Скачать шаблон). Будет создан пустой проект на основе конвейера Universal Render Pipeline (URP).
Введите название проекта, место сохранения и организацию Unity.
В левой части окна Project Settings (Настройки проекта) выберите XR Plug-in Management (Управление плагинами XR).
Если система управления плагинами XR Plugin Management не установлена, нажмите Install XR Plugin Management (Установить систему управления плагинами XR).
Выберите поставщика OpenXR на вкладке со значком в виде компьютера.
В разделе Platforms (Платформы) выберите Meta Quest и нажмите Enable Platform (Включить платформу). Если вы уже установили профиль, нажмите Switch Platform (Сменить платформу).
Если вам будет предложено установить com.unity.xr.openxr, нажмите Install (Установить).
Unity versions prior to 6.1
Если в вашей версии Unity нет платформы Meta Quest, выберите платформу разработки Android.
Выберите My Assets (Мои объекты) в окне Package Manager (Диспетчер пакетов). Должны появиться объекты Meta XR, которые вы добавили из магазина объектов Unity Asset Store.
Выберите Meta XR Core SDK и нажмите Install (Установить).
Если появится запрос на включение набора функций Meta XR, нажмите Enable (Включить).
Если эта функция не включена, активируйте ее: для этого выберите Edit (Редактировать) > Project Settings (Настройки проекта). Выберите XR Plug-in Management (Управление плагином XR) и убедитесь, что Meta XR Feature group (Группа функций Meta XR) включена на отдельной вкладке и на вкладке группы Meta.
Когда появится запрос на перезапуск редактора Unity, нажмите Restart Editor (Перезапустить редактор).
После того как редактор Unity снова откроется, в окне Package Manager (Диспетчер пакетов) выберите Meta XR Interaction SDK и нажмите Install (Установить).
Когда появится запрос на обновление скелета руки, выберите Use OpenXR Hand (Использовать руку OpenXR).
Обновление конфигурации с помощью инструмента настройки проекта
В верхней части редактора Unity в раскрывающемся списке Meta XR Tools (Инструменты Meta XR) выберите Project Setup Tool (Инструмент настройки проекта).
Нажмите Fix All (Исправить всё) и Apply All (Применить всё) на вкладке компьютера и на вкладке Meta.
Обновление конфигурации с помощью инструмента проверки проекта
На отдельной вкладке и на вкладке Meta нажмите Fix All (Исправить всё) и Apply All (Применить всё).
Подтверждение выбора групп функций OpenXR
Выберите Project Settings (Настройки проекта) > XR Plug-In Management > OpenXR и перейдите на вкладку Android.
Выберите Meta XR в разделе OpenXR Feature Groups (Группы функций OpenXR), чтобы отфильтровать список.
Убедитесь, что параметры Meta XR Feature (Функция Meta XR), Meta XR Foveation (Углубление Meta XR) и Meta XR Subsampled Layout (Субдискретизированный макет Meta XR) включены.
Шаг 3. Добавьте строительные блоки в сцену
Строительные блоки — это модульные компоненты в Meta XR SDK, которые можно использовать для быстрого доступа к таким функциям Meta Quest, как контроллер и отслеживание движений рук. Чтобы добавить строительные блоки в сцену, следуйте инструкциям ниже:
Добавление рига камеры
В панели Hierarchy (Иерархия) удалите Main Camera (Основная камера) из раздела проекта SampleScene (Пример сцены).
В раскрывающемся меню инструментов в вашем редакторе выберите Meta XR Tools (Инструменты Meta XR) > Building Blocks (Строительные блоки).
В окне Building Blocks (Строительные блоки) найдите строительный блок Camera Rig (Риг камеры) и нажмите на значок в правом нижнем углу этого блока, чтобы добавить его в проект.
Убедитесь, что объект Camera Rig (Риг камеры) находится в панели Hierarchy (Иерархия).
Добавление взаимодействия взятием
В меню инструментов выберите Meta XR Tools (Инструменты Meta XR) > Building Blocks (Строительные блоки).
В окне Building Blocks (Строительные блоки) найдите строительный блок Grab Interaction (Взаимодействие взятием) и нажмите на значок в правом нижнем углу этого блока, чтобы добавить его в проект.
В разделе Hierarchy (Иерархия) выберите [BuildingBlock] Cube ([Строительный блок] Куб).
В пункте Inspector (Инспектор) раздела Transform (Трансформация) установите для параметра Position (Положение) значения (0, 1, 0,25), чтобы переместить объект в поле зрения.
Шаг 4. Откройте предварительный просмотр сцены
Открыть предварительный просмотр сцены можно на гарнитуре Meta Quest или на компьютере с помощью Meta XR Simulator.
Предварительный просмотр с помощью Meta XR Simulator (гарнитура не требуется)
Meta XR Simulator — это автономное приложение, позволяющее открыть предварительный просмотр сцены на компьютере без использования гарнитуры.
Скачайте и установите Meta XR Simulator для своей операционной системы:
Прежде чем включить режим разработчика, убедитесь, что соблюдены следующие предварительные условия:
Вы являетесь зарегистрированным разработчиком Meta с подтвержденным аккаунтом Meta. Чтобы проверить статус своего аккаунта, выберите Verification (Подтверждение) на Панели разработчика.
Вы не должны быть младше 18 лет.
На вашей гарнитуре нет ограничений на уровне устройства, которые препятствуют включению режима разработчика.
Чтобы включить режим разработчика:
Откройте приложение Meta Horizon на мобильном устройстве.
В приложении нажмите на значок гарнитуры на панели инструментов.
Связанная гарнитура должна появиться в верхней части экрана. Выберите элемент гарнитуры, где будут показаны модель и статус связанной гарнитуры.
Выберите Headset Settings (Настройки гарнитуры) под изображением гарнитуры.
Нажмите Developer Mode (Режим разработчика).
Включите Developer Mode (Режим разработчика) с помощью переключателя.
Подключите гарнитуру к компьютеру с помощью кабеля USB-C.
Примечание. Чтобы настроить устройство без компьютера, ознакомьтесь с документацией по настройке вашего конкретного устройства в Справочном центре Meta Quest.
Наденьте гарнитуру.
Откройте на гарнитуре пункт меню Quick Control (Быстрое управление).
Выберите Open Settings (Открыть настройки), что отображается в виде значка шестеренки. Затем откройте вкладку Developer (Разработчик) и включите переключатель MTP Notification (Уведомление MTP).
Когда появится запрос на разрешение отладки через USB, выберите Always allow from this computer (Всегда разрешать с этого компьютера).
Режим разработчика предназначен для выполнения задач, связанных с разработкой, таких как запуск, отладка и тестирование приложений. Его использование для других целей может привести к ограничению, приостановке или прекращению действия аккаунта. Подробнее см. в Правилах в отношении контента.
Нажмите кнопку Play (Воспроизвести) в верхней части редактора Unity.
Возьмите VR-куб рукой, сведя пальцы.
Возьмите VR-куб с помощью кнопки на рукоятке контроллера.
Вы закончили этот обучающий курс. Теперь у вас есть проект Unity 3D, который вы можете использовать для разработки приложений для VR-гарнитур Meta Quest. Чтобы продолжить обучение, изучите материалы из следующего раздела.
Статьи по теме
Чтобы продолжить обучение, изучите следующие ресурсы:
Разработка VR-игры с помощью ИИ-инструментов Unity. Используйте ИИ-инструменты для создания полноценной VR-игры для Meta Quest — от настройки проекта до пользовательских шейдеров и пространственного звука.
Обзор примеров проектов Unity. Примеры сцен, мотивов и проектов, разработанных инженерами Meta, чтобы помочь вам создавать VR-приложения в Unity.
Обзор Meta XR Simulator: пакет, который позволяет предварительно просматривать сцену на компьютере.
Центр разработки Meta Quest: приложение, которое позволяет управлять устройствами, генерировать проекты Unity, выполнять отладку приложений и публиковать приложения в Магазине Meta Horizon.