Unity Hello World для VR-гарнитур Meta Quest

• как настроить проект Unity 3D, работающий на VR-гарнитурах Meta Quest;
• как добавлять VR-взаимодействия в сцену Unity;
• как предварительно просматривать свое приложение на VR-устройстве Meta Quest или на компьютере.

• Компьютер для разработки под управлением одной из следующих операционных систем:
  • Windows 10 и более поздние версии (64-разрядные);
  • macOS 10.10 и более поздние версии (x86 или ARM).

• компьютер для разработки на базе 64-разрядной ОС Windows 10 или более поздней версии с совместимой видеокартой. Подробнее см. Требования к ПК на базе Windows для использования Meta Horizon Link⁠.
• Поддерживаемые гарнитуры Meta Quest:
  • Quest 2
  • Quest Pro
  • Quest 3
  • Quest 3S и 3S Xbox Edition

• Один из следующих способов подключения гарнитуры к компьютеру для разработки:
  • кабель данных USB-C (рекомендуется);
  • подключение обоих устройств к одной сети Wi-Fi.

• Мобильное устройство на базе Android или iOS
  • Мобильное приложение Meta Horizon⁠

• ID Unity: войдите в свой аккаунт Unity или создайте новый⁠.
• Аккаунт разработчика Meta Horizon: зарегистрируйте аккаунт Meta.

1. Скачайте Unity Hub с сайта скачиваемых файлов для Unity⁠.
2. Запустите установщик Unity Hub и дождитесь завершения установки.

1. Откройте приложение Unity Hub.
2. На левой панели навигации, где показываются версии редактора Unity, выберите Installs (Установки).
3. Нажмите Install Editor (Установить редактор) и выберите версию Unity 6.1 или более позднюю.
4. На экране Add module (Добавить модуль) выберите пункты Android Build Support (Поддержка разработки на Android) в разделе Platforms (Платформы).
   
5. Нажмите Install (Установить).

1. Откройте веб-браузер и перейдите в магазин Unity Asset Store⁠.
2. Войдите в свой аккаунт Unity и выберите организацию, которую вы выбрали для проекта.
3. Откройте следующие страницы Unity Asset:
   • Meta XR Core SDK⁠;
   • Meta XR Interaction SDK⁠
   • Meta XR Simulator⁠
   • Meta XR Platform SDK⁠.
4. На странице каждого объекта нажмите Add to My Assets (Добавить в мои объекты). На следующем изображении показана кнопка для Meta XR Core SDK:
   

1. На левой панели навигации выберите Projects (Проекты) и нажмите New project (Создать проект).
   
2. Выберите редактор Unity 6.1 или более поздней версии.
3. Выберите шаблон Universal 3D (Универсальный шаблон 3D). Если хотите скачать шаблон, нажмите Download template (Скачать шаблон). Будет создан пустой проект на основе конвейера Universal Render Pipeline (URP).
4. Введите название проекта, место сохранения и организацию Unity.
5. Нажмите Create project (Создать проект).
   

1. Выберите Edit (Редактировать) > Project Settings (Настройки проекта) в меню редактора Unity.
   
2. В левой части окна Project Settings (Настройки проекта) выберите XR Plug-in Management (Управление плагинами XR).
3. Если система управления плагинами XR Plugin Management не установлена, нажмите Install XR Plugin Management (Установить XR Plugin Management).
   
4. Отметьте поставщика OpenXR в отдельной вкладке группы.
   
5. Отметьте поставщика OpenXR на вкладке группы Meta.
   

1. В меню редактора Unity выберите File (Файл) > Build Profiles (Профили сборки).
2. В разделе Platforms (Платформы) выберите Meta Quest и нажмите Enable Platform (Включить платформу). Если вы уже установили профиль, нажмите Switch Platform (Сменить платформу).
   
3. Если вам будет предложено установить com.unity.xr.openxr, нажмите Install (Установить).

1. В меню редактора Unity выберите Window (Окно) > Package Management (Управление пакетами) > Package Manager (Диспетчер пакетов).
   
2. Выберите My Assets (Мои объекты) в окне Package Manager (Диспетчер пакетов). Должны появиться объекты Meta XR, которые вы добавили из магазина объектов Unity Asset Store.
   
3. Выберите Meta XR Core SDK и нажмите Install (Установить).
   
4. Если появится запрос на включение набора функций Meta XR, нажмите Enable (Включить).
   
   Если эта функция не включена, активируйте ее: для этого выберите Edit (Редактировать) > Project Settings (Настройки проекта). Выберите XR Plug-in Management (Управление плагином XR) и убедитесь, что Meta XR Feature group (Группа функций Meta XR) включена на отдельной вкладке и на вкладке группы Meta.
5. Когда появится запрос на перезапуск редактора Unity, нажмите Restart Editor (Перезапустить редактор).
   
6. После того как редактор Unity снова откроется, в окне Package Manager (Диспетчер пакетов) выберите Meta XR Interaction SDK и нажмите Install (Установить).
   
7. Когда появится запрос на обновление скелета, выберите Use OpenXR Hand (Использовать руку OpenXR).
   
8. Выберите Meta XR Simulator и нажмите Install (Установить).
   

1. В верхней части редактора Unity в раскрывающемся списке Meta XR Tools (Инструменты Meta XR) выберите Project Setup Tool (Инструмент настройки проекта).
   
2. Нажмите Fix All (Исправить всё) и Apply All (Применить всё) на отдельной вкладке и вкладке Meta.
   

1. Выберите Project Settings (Настройки проекта) > XR Plug-In Management (Управление плагинами XR) > Project Validation (Проверка проекта).
2. Нажмите Fix All (Исправить всё) на отдельной вкладке и вкладке Meta.
   

1. Выберите Project Settings (Настройки проекта) > XR Plug-In Management (Управление плагинами XR) > OpenXR и перейдите на вкладку Android.
2. Выберите Meta XR в разделе OpenXR Feature Groups (Группы функций OpenXR), чтобы отфильтровать список.
3. Убедитесь, что параметры Meta XR Feature (Функция Meta XR), Meta XR Foveation (Углубление Meta XR) и Meta XR Subsampled Layout (Субдискретизированный макет Meta XR) включены.
   

1. В панели Hierarchy (Иерархия) удалите Main Camera (Основная камера) из раздела проекта SampleScene (Пример сцены).
   
2. В раскрывающемся меню инструментов в вашем редакторе выберите Meta XR Tools (Инструменты Meta XR) > Building Blocks (Строительные блоки).
   
3. В окне Building Blocks (Строительные блоки) найдите строительный блок Camera Rig (Риг камеры) и нажмите значок в правом нижнем углу этого блока, чтобы добавить его в проект.
   
4. Убедитесь, что объект Camera Rig (Риг камеры) находится в панели Hierarchy (Иерархия).
   

1. В раскрывающемся меню инструментов в вашем редакторе выберите Meta XR Tools (Инструменты Meta XR) > Building Blocks (Строительные блоки).
2. В окне Building Blocks (Строительные блоки) найдите строительный блок Grab Interaction (Взаимодействие взятием) и нажмите значок в правом нижнем углу этого блока, чтобы добавить его в проект.
   
3. В разделе Hierarchy (Иерархия) выберите [BuildingBlock] Cube (Куб [BuildingBlock]).
   
4. В пункте Inspector (Инспектор) раздела Transform (Трансформация) установите для параметра Position (Положение) значения (0, 1, 0,25), чтобы переместить объект в поле зрения.
   

1. Откройте приложение Meta Horizon на мобильном устройстве.
   Инструкции по установке мобильного приложения Meta Horizon можно найти в статье Установка мобильного приложения Meta Horizon на телефон⁠.
2. Войдите в приложение, используя учетные данные аккаунта разработчика Meta.
3. Свяжите гарнитуру с приложением.
4. Наденьте гарнитуру и следуйте инструкциям на ней, чтобы завершить настройку.

• Вы являетесь зарегистрированным разработчиком Meta с подтвержденным аккаунтом Meta. Чтобы проверить статус своего аккаунта, выберите Verification (Подтверждение)⁠ на Панели разработчика.
• Вы не должны быть младше 18 лет.
• На вашей гарнитуре нет ограничений на уровне устройства, которые препятствуют включению режима разработчика.

1. Откройте приложение Meta Horizon на мобильном устройстве.
2. В приложении нажмите на значок гарнитуры на панели инструментов.
   
3. Связанная гарнитура должна появиться в верхней части экрана. Выберите элемент гарнитуры, где будут показаны модель и статус связанной гарнитуры.
   
4. Выберите Headset Settings (Настройки гарнитуры) под изображением гарнитуры.
   
5. Нажмите Developer Mode (Режим разработчика).
   
6. Включите Developer Mode (Режим разработчика) с помощью переключателя.
   
7. Подключите гарнитуру к компьютеру с помощью кабеля USB-C.
   Примечание. Чтобы настроить устройство без компьютера, ознакомьтесь с документацией по настройке вашего конкретного устройства в Справочном центре Meta Quest⁠.
8. Наденьте гарнитуру.
9. Откройте на гарнитуре пункт меню Quick Control (Быстрое управление).
10. Выберите Open Settings (Открыть настройки), что отображается в виде значка шестеренки. Затем откройте вкладку Developer (Разработчик) и включите переключатель MTP Notification (Уведомление MTP).
11. Когда появится запрос на разрешение отладки через USB, выберите Always allow from this computer (Всегда разрешать с этого компьютера).
    

1. Скачайте приложение Meta Horizon Link⁠ и установите на компьютере с ОС Windows.
2. Перезагрузите компьютер, если программа установки попросит вас это сделать.
3. Откройте приложение.

1. Подключите гарнитуру к компьютеру с помощью кабеля USB-C.
2. Наденьте гарнитуру. Если вам будет предложено запустить Link, нажмите Включить.
3. Если такого сообщения не появится, перейдите в раздел Быстрые настройки > Настройки > Link > Включить Link > Запустить Link.

1. Нажмите кнопку Play (Воспроизвести) в верхней части редактора Unity.
   
2. Возьмите VR-куб рукой, сведя пальцы.
   
3. Возьмите VR-куб с помощью кнопки на рукоятке контроллера.
   

• Краткое руководство по созданию прототипа с отслеживанием движений рук: создайте пользовательский интерфейс с отслеживанием движений рук, содержащий кнопки, ползунки и переключатели. Ваш проект уже настроен. Можно приступать к разработке.
• Разработка приложений Unity для VR-гарнитур Meta Quest: основные компоненты и темы, касающиеся разработки, тестирования и отладки приложений.
• Вводная информация о смешанной реальности в Meta Quest: иммерсивные режимы и сценарии использования.
• Обзор примеров проектов Unity: примеры сцен, мотивов и проектов, разработанных инженерами Meta, чтобы помочь вам создавать VR-приложения в Unity.
• Решения платформы: социальные функции, многопользовательские приложения и инструменты для коммерции, которые вы можете интегрировать в свое приложение с помощью SDK платформы.
• Обзор Meta XR Simulator: пакет, который позволяет предварительно просматривать сцену на компьютере.
• Центр разработки Meta Quest: приложение, которое позволяет управлять устройствами, генерировать проекты Unity, выполнять отладку приложений и публиковать приложения в Магазине Meta Horizon.