Разработка

Настройка Unity для разработки VR-приложений

Обновлено: 28 апр 2026 г.

Подготовка и настройка среды разработки Unity 3D для создания VR-приложений для гарнитур Meta Quest. В этом обучающем курсе содержатся инструкции по настройке следующих компонентов:

XR provider (Поставщик XR) — позволяет Unity взаимодействовать с устройствами Meta Quest и управлять их отслеживанием, вводом и рендерингом;

Meta XR Core SDK — предоставляет инструменты и компоненты для оптимизации и улучшения разработки VR-приложений для устройств Meta.

Meta XR Platform SDK — обеспечивает управление идентификационными данными, проверку прав и доступ к функциям платформы, таким как подбор игроков, покупки в приложении, достижения и социальное взаимодействие. Необходим ID приложения с Панели разработчика Meta Horizon⁠.

Project Setup Tool (Инструмент настройки проекта) — управляет настройками и зависимостями проектов Unity.

Если вы новичок в разработке приложений Unity на Quest, ознакомьтесь с руководством Hello World, чтобы создать свое первое VR-приложение.

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

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

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

Компьютер для разработки под управлением одной из следующих операционных систем:

Windows 10 и более поздние версии (64-разрядные);

macOS 10.10 и более поздние версии (x86 или ARM).

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

Редактор Unity 2022.3.15f1 или более поздней версии (рекомендуется версия 6.1 или более поздняя)

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

ID Unity: войдите в свой аккаунт Unity или создайте новый⁠

Добавление модуля Android Build Support

Устройства Meta Quest работают на базе ОС Android. Для сборки и развертывания приложений им необходим модуль Unity Android Build Support (Поддержка сборки Android). Чтобы добавить этот модуль и необходимые компоненты, выполните следующие действия:

Откройте Unity Hub.

На левой панели навигации, где показываются версии редактора Unity, выберите Installs (Установки).

Если панель пуста, нажмите Install Editor (Установить редактор) и выберите совместимую версию. Для устройств Meta Quest требуется версия 2022.3.15f1 или более поздняя (рекомендуется версия 6.1 или более поздняя). Нажмите Install (Установить), чтобы начать установку.

После завершения нажмите Installs (Установки) на левой панели навигации для подтверждения.

Затем в меню рядом с установленной версией Unity выберите Manage (Управление) > Add modules (Добавить модули).

Выберите следующие компоненты и нажмите Install (Установить):

Android Build Support;

OpenJDK;

инструменты Android SDK и NDK.

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

Чтобы создать проект в Unity Hub, выполните следующие действия:

На левой панели навигации выберите Projects (Проекты) и нажмите New project (Создать проект).

Выберите редактор Unity 6.1 или более поздней версии.

Выберите шаблон Universal 3D (Универсальный шаблон 3D). Если хотите скачать шаблон, нажмите Download template (Скачать шаблон). Будет создан пустой проект на основе конвейера Universal Render Pipeline (URP).

Введите название проекта, место сохранения и организацию Unity.

Нажмите Create project (Создать проект).

Настройка платформы сборки

В меню редактора Unity выберите File (Файл) > Build Profiles (Профили сборки).

В разделе Platforms (Платформы) выберите Meta Quest и нажмите Enable Platform (Включить платформу). Если вы уже установили профиль, нажмите Switch Platform (Сменить платформу).

Если вам будет предложено установить com.unity.xr.openxr, нажмите Install (Установить).

Unity versions prior to 6.1

Если в вашей версии Unity нет поддержки платформы Meta Quest, выберите платформу сборки Android.

Узнать больше о профилях сборки Unity можно в статье Обзор конфигурации сборки.

Установка плагина поставщика XR

Плагин поставщика XR добавляет в Unity поддержку устройств XR, в том числе гарнитур. Выберите поставщика, который соответствует требованиям вашего проекта.

Устройства Meta Quest поддерживают следующие плагины поставщиков:

Unity OpenXR⁠ (рекомендуется).

Рекомендуемая версия: 1.15.1.

Требуется Unity 6 или более поздняя версия и Meta XR SDK 74 или более поздняя версия.

Плагин Oculus XR Plugin⁠ (упразднен)

Рекомендуемая версия: 4.5.1

Требуется Unity версии 2022 или более поздней и Meta XR SDK версии 73 или более ранней.

Oculus XR Plugin is deprecated

Плагин Oculus XR упразднен и будет удален. Используйте вместо него Unity OpenXR Plugin.

Подробнее о плагинах поставщиков XR см. в статье Управление плагинами XR для Meta Quest.

Вариант А. Установка Unity OpenXR Plugin

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

Чтобы установить плагин поставщика OpenXR:

Откройте любой 3D-проект в редакторе Unity 2022.3.15f1 или более поздней версии (рекомендуется версия 6.1 или более поздняя).

В верхнем меню Unity Editor выберите Edit (Редактирование) > Project Settings (Настройки проекта).

Выберите XR Plug-in Management (Управление плагинами XR) в окне Project Settings (Настройки проекта).

Если система управления плагинами XR Plugin Management не установлена, выберите Install XR Plugin Management (Установить XR Plugin Management).

На вкладке настроек для Windows, Mac и Linux выберите OpenXR.

На вкладке настроек для Android и Meta Quest выберите OpenXR.

Закройте окно Project Settings (Настройки проекта).

В верхнем меню редактора Unity выберите Window (Окно) > Package Management (Управление пакетами) > Package Manager (Диспетчер пакетов), чтобы открыть окно диспетчера пакетов Unity.

В левом меню навигации убедитесь, что выделен вариант In Project (В проекте). В разделе Search in Project (Искать в проекте) раскройте список Packages (Пакеты) - Unity.

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

Подробнее о настройке плагина OpenXR см. в документации по настройкам плагина Unity OpenXR.

Вариант Б. Установка Oculus XR Plugin

Oculus XR Plugin is deprecated

Плагин Oculus XR упразднен и будет удален. Используйте вместо него Unity OpenXR Plugin.

Для проектов на базе Unity версии до 6, использующих Meta XR SDK версии до 74, установите Oculus XR Plugin.

Для этого сделайте следующее:

Откройте любой 3D-проект в редакторе Unity версии 2022 или 2023.

В верхнем меню редактора Unity выберите Edit (Редактирование) > Project Settings (Настройки проекта).

Выберите XR Plug-in Management (Управление плагинами XR) в окне Project Settings (Настройки проекта).

На вкладке настроек для Windows, Mac или Linux выберите Oculus.

На вкладке настроек для Android выберите Oculus.

Закройте окно настроек проекта.

В левом верхнем углу окна раскройте список Packages - Unity (Пакеты: Unity).

В списке пакетов в меню слева убедитесь, что рядом с плагином Oculus стоит галочка, означающая, что пакет установлен.

Примечание. Установка плагина XR не приводит к скачиванию и импорту Meta XR SDK в ваш проект. Обязательно добавьте Meta XR SDK, которые вам необходимы, из магазина Unity Asset Store⁠.

Импорт Meta XR Core SDK

Meta разрабатывает и поддерживает несколько SDK Unity, предназначенных для разработки приложений виртуальной реальности (VR) и расширенной реальности (XR). Если вы только начали, скачайте Meta XR Core SDK⁠ из магазина Unity Asset Store. Этот SDK включает основные компоненты и объекты для разработки.

Чтобы добавить Meta XR Core SDK в свой проект, сделайте следующее:

Войдите в магазин Meta Quest в Unity Asset Store⁠, используя свои учетные данные Unity.

Выберите Meta XR Core SDK⁠ или перейдите на его страницу.

Нажмите Add to My Assets (Добавить в мои объекты), чтобы добавить пакет к объектам вашего аккаунта Unity.

Нажмите Open in Unity (Открыть в Unity), чтобы открыть окно Package Manager (Диспетчер пакетов) в редакторе Unity.

По запросу введите свои учетные данные Unity.

В окне Package Manager (Диспетчер пакетов) в правом верхнем углу выберите Install (Установить), чтобы установить SDK.

Если появится запрос, нажмите Enable (Включить) для набора функций Meta XR, чтобы утилиты работали должным образом.

Когда появится запрос на перезапуск редактора Unity, нажмите Restart Editor (Перезапустить редактор).

Узнать больше о пакетах Meta XR можно на странице справки по пакетам Meta XR.

Импорт Meta XR Platform SDK

Meta XR Platform SDK⁠ предоставляет доступ к функциям платформы, необходимым для разработки под Meta Quest, в том числе к управлению идентификационными данными, проверкам прав и социальным функциям. Этот SDK и ID приложения необходимы, чтобы разблокировать такие функции, как аутентификация пользователей, подбор игроков, покупки в приложении, достижения и облачное хранилище.

Чтобы добавить Meta XR Core SDK в свой проект, сделайте следующее:

Перейдите на страницу Meta XR Platform SDK⁠ в Unity Asset Store и войдите в систему со своими учетными данными Unity.

Нажмите Add to My Assets (Добавить в мои объекты), чтобы добавить пакет к объектам вашего аккаунта Unity.

Нажмите Open in Unity (Открыть в Unity), чтобы открыть окно Package Manager (Диспетчер пакетов) в редакторе Unity.

По запросу введите свои учетные данные Unity.

В окне Package Manager (Диспетчер пакетов) нажмите Install (Установить), чтобы установить SDK.

Когда появится запрос на перезапуск редактора Unity, нажмите Restart Editor (Перезапустить редактор).

После установки SDK, чтобы инициализировать его, вам понадобится ID приложения. Чтобы получить ID приложения, создайте приложение на Панели разработчика Meta Horizon⁠ и скопируйте ID приложения со страницы API. Подробные инструкции можно найти в разделе Настройка приложения платформы для разработки Unity.

Подробнее о функциях решений платформы см. в статье Обзор решений платформы.

Подтверждение включения функций OpenXR

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

Убедитесь, что для этого проекта вы включили следующие функции, чтобы получить к ним доступ на гарнитуре Meta Quest:

Meta XR;

фовеация Meta XR;

подвыборочная компоновка Meta XR.

Чтобы найти и включить эти функции:

Выберите Project Settings (Настройки проекта) > XR Plug-In Management (Управление плагинами XR) > OpenXR и перейдите на вкладку Android.

Выберите Meta XR в разделе OpenXR Feature Groups (Группы функций OpenXR), чтобы открыть список функций Meta XR.

Управление зависимостями проекта с помощью инструмента настройки проекта

Project Setup Tool (Инструмент настройки проекта) — это расширение редактора Unity, которое позволяет быстро настраивать проекты Unity и устранять проблемы с зависимостями в них для разработки Meta VR. Чтобы устранить проблемы с зависимостями в своем проекте, сделайте следующее:

В редакторе Unity выберите Meta > Tools (Инструменты) > Project Setup Tool (Инструмент настройки проекта). Вы можете также нажать Meta XR Tools (Инструменты Meta XR) в верхней части редактора Unity и выбрать во всплывающем меню Project Setup Tool (Инструмент настройки проекта).

Чтобы устранить все нерешенные проблемы для платформы Android, нажмите Fix All (Исправить все).

Чтобы применить все рекомендуемые настройки для платформы Android, нажмите Apply All (Применить все).

Подробнее об инструменте настройки проекта см. на странице справки по инструменту настройки проекта.

Подробнее о настройке проектов Unity вручную см. в статье Обзор конфигурации проектов.