Разработка

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

Обновлено: 15 мая 2026 г.
Интерактивный курс Создание приложения для Магазина Meta Horizon поможет вам создать и запустить свое первое приложение в Магазине Meta Horizon. Узнайте, как с помощью инструментов, рекомендаций и ресурсов сообщества Meta эффективно планировать, разрабатывать и запускать приложения.
В этом руководстве приведены инструкции по настройке Unity для VR-разработки для Meta Quest. Вы узнаете:
  • как настроить проект Unity 3D, работающий на VR-гарнитурах Meta Quest;
  • как добавлять VR-взаимодействия в сцену Unity;
  • как открыть предварительный просмотр приложения на VR-устройстве Meta Quest или на компьютере.
Unity Editor Game view showing a tracked hand grabbing a blue cube in a VR scene

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

Перед началом работы с этим обучающим курсом убедитесь, что соблюдаются перечисленные далее требования.

Требования к оборудованию

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

Требования к предпросмотру на гарнитуре

Для запуска приложения Meta Horizon Link, подключающего вашу гарнитуру к компьютеру для разработки, необходимо следующее:
  • Один из следующих способов подключения гарнитуры к компьютеру для разработки:
    • кабель данных USB-C (рекомендуется);
    • подключение обоих устройств к одной сети Wi-Fi.
Streaming scenes to a headset requires Windows
Meta Horizon Link позволяет транслировать на гарнитуру сцены из редактора Unity для тестирования в режиме реального времени, но для этого требуется компьютер Windows. Вы по-прежнему можете собирать и устанавливать приложения на гарнитуру с macOS или Windows, а также проводить тестирование без гарнитуры на обеих платформах с помощью Meta XR Simulator.
Чтобы развернуть приложение на гарнитуре, установите APK на устройство через Центр разработки Meta Quest. Чтобы проводить тестирование без гарнитуры в macOS (только ARM) или Windows, установите Meta XR Simulator.

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

Шаг 1. Настройте редактор Unity и объекты

Установка Unity Hub

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

Установка редактора Unity

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

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

Создание проекта Unity

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

Установка плагина Unity OpenXR

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

Добавление и выбор платформы сборки Meta Quest

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

Добавление Meta XR SDK в проект

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

Обновление конфигурации с помощью инструмента настройки проекта

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

Обновление конфигурации с помощью инструмента проверки проекта

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

Подтверждение выбора групп функций OpenXR

  1. Выберите Project Settings (Настройки проекта) > XR Plug-In Management > 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) включены.
    Selected OpenXR feature groups

Шаг 3. Добавьте строительные блоки в сцену

Строительные блоки — это модульные компоненты в Meta XR SDK, которые можно использовать для быстрого доступа к таким функциям Meta Quest, как контроллер и отслеживание движений рук. Чтобы добавить строительные блоки в сцену, следуйте инструкциям ниже:

Добавление рига камеры

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

Добавление взаимодействия взятием

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

Шаг 4. Откройте предварительный просмотр сцены

Открыть предварительный просмотр сцены можно на гарнитуре Meta Quest или на компьютере с помощью Meta XR Simulator.

Предварительный просмотр с помощью Meta XR Simulator (гарнитура не требуется)

Meta XR Simulator — это автономное приложение, позволяющее открыть предварительный просмотр сцены на компьютере без использования гарнитуры.
  1. Скачайте и установите Meta XR Simulator для своей операционной системы:
  2. Чтобы активировать симулятор и открыть предпросмотр сцены, выполните действия из раздела Начало работы с Meta XR Simulator.

Предварительный просмотр на гарнитуре Meta Quest

Чтобы открыть предварительный просмотр сцены на гарнитуре, следуйте инструкциям ниже.

Связывание гарнитуры с мобильным приложением Meta Horizon

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

Включение режима разработчика

Прежде чем включить режим разработчика, убедитесь, что соблюдены следующие предварительные условия:
  • Вы являетесь зарегистрированным разработчиком Meta с подтвержденным аккаунтом Meta. Чтобы проверить статус своего аккаунта, выберите Verification (Подтверждение) на Панели разработчика.
  • Вы не должны быть младше 18 лет.
  • На вашей гарнитуре нет ограничений на уровне устройства, которые препятствуют включению режима разработчика.
Чтобы включить режим разработчика:
  1. Откройте приложение Meta Horizon на мобильном устройстве.
  2. В приложении нажмите на значок гарнитуры на панели инструментов.
    Meta Horizon toolbar
  3. Связанная гарнитура должна появиться в верхней части экрана. Выберите элемент гарнитуры, где будут показаны модель и статус связанной гарнитуры.
    Paired headset item
  4. Выберите Headset Settings (Настройки гарнитуры) под изображением гарнитуры.
    Headset settings
  5. Нажмите Developer Mode (Режим разработчика).
    Developer mode list item
  6. Включите Developer Mode (Режим разработчика) с помощью переключателя.
    Toggle Developer Mode to the on position
  7. Подключите гарнитуру к компьютеру с помощью кабеля USB-C.
    Примечание. Чтобы настроить устройство без компьютера, ознакомьтесь с документацией по настройке вашего конкретного устройства в Справочном центре Meta Quest.
  8. Наденьте гарнитуру.
  9. Откройте на гарнитуре пункт меню Quick Control (Быстрое управление).
  10. Выберите Open Settings (Открыть настройки), что отображается в виде значка шестеренки. Затем откройте вкладку Developer (Разработчик) и включите переключатель MTP Notification (Уведомление MTP).
  11. Когда появится запрос на разрешение отладки через USB, выберите Always allow from this computer (Всегда разрешать с этого компьютера).
    Allow USB Debugging prompt
Режим разработчика предназначен для выполнения задач, связанных с разработкой, таких как запуск, отладка и тестирование приложений. Его использование для других целей может привести к ограничению, приостановке или прекращению действия аккаунта. Подробнее см. в Правилах в отношении контента.
  1. Скачайте приложение Meta Horizon Link и установите на компьютере с ОС Windows.
  2. Перезагрузите компьютер, если программа установки попросит вас это сделать.
  3. Откройте приложение.

Подключите гарнитуру.

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

Взаимодействие со сценой в гарнитуре

  1. Нажмите кнопку Play (Воспроизвести) в верхней части редактора Unity.
    Press Play
  2. Возьмите VR-куб рукой, сведя пальцы.
    Grab the cube using your hand
  3. Возьмите VR-куб с помощью кнопки на рукоятке контроллера.
    Grab the cube using your controller
Вы закончили этот обучающий курс. Теперь у вас есть проект Unity 3D, который вы можете использовать для разработки приложений для VR-гарнитур Meta Quest. Чтобы продолжить обучение, изучите материалы из следующего раздела.

Статьи по теме

Чтобы продолжить обучение, изучите следующие ресурсы:
Логотип навигации
Русский
© 2026 Meta