Разработка

Выберите платформу

Использование Link для разработки приложений

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

Инструмент Link помогает сократить время итерации, запуская приложение, которое вы разрабатываете в Unity или Unreal, непосредственно из редактора на вашем устройстве при нажатии Play(►) (Воспроизвести). Вам не придется собирать приложение на ПК и устанавливать его на гарнитуру Meta Quest каждый раз при тестировании в процессе разработки.

Примечание. В настоящее время Link поддерживается только в Windows. Если вы разрабатываете в macOS или не имеете доступа к гарнитуре, используйте Meta XR Simulator.

В этом разделе:

описывается приложение разработчика Meta Horizon Link;

перечислены ресурсы для настройки и базового использования Link;

описаны полезные настройки и способы устранения неполадок при тестировании приложений с использованием Link.

Инструмент Link совместим с гарнитурами Meta Quest 3S, Meta Quest 3, Meta Quest 2 и Meta Quest Pro.

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

Аккаунт разработчика Meta

Требования для использования Link⁠

Ограничения

Приложения, выпущенные через Магазин Meta Horizon, не имеют доступа к функциям разработки и экспериментальным функциям, даже если эти функции включены в настройках Link.

Важно! Чтобы убедиться, что все функции работают надлежащим образом, перед выпуском своего приложения в Магазин Meta Horizon проверьте его на устройстве.

Внешний вид и характеристики производительности приложения при работе через Link могут отличаться от демонстрируемых при запуске на гарнитуре Meta Quest.

При использовании Link ваше устройство будет вести себя как гарнитура виртуальной реальности для ПК до полного отключения этого инструмента.

Настройка Meta Horizon Link

Чтобы просмотреть сцену через Link, выполните следующие действия:

Скачайте Link⁠ и установите его на свой компьютер.

Наденьте гарнитуру.

Откройте Settings (Настройки) на гарнитуре.

Выберите Quest Link и включите переключатель Quest Link.

Выберите Launch Quest Link (Запустить Quest Link), чтобы запустить Link на компьютере для разработки и на гарнитуре.

В проекте Unity нажмите Play(►) (Воспроизвести), чтобы запустить приложение на гарнитуре.

Настройка параметров для разработки

Активация среды выполнения OpenXR

В приложении Meta Quest Link выберите Settings (Настройки) > General (Общие).

Затем перейдите к OpenXR Runtime (Среда выполнения OpenXR) и выберите Set Meta Quest Link as active (Активировать Meta Quest Link). После активации параметр становится серым.

Переключение функций разработчика в среде выполнения

В приложении Meta Quest Link выберите Settings (Настройки) > Beta (Бета-версия).

Убедитесь, что параметр Developer Runtime Features (Функции разработчика в среде выполнения) включен.

Поддержка функций через Link

Предположим, что вы хотите протестировать приложение, которое использует сквозную камеру, Passthrough Camera API, отслеживание движений глаз и естественную мимику.

В приложении Meta Horizon Link выберите Settings (Настройки) > Developer (Разработчик).

Убедитесь, что следующие параметры включены:

Сквозная камера через Meta Horizon Link

Разрешения Passthrough Camera API (доступны в версии 2.1 и выше)

Отслеживание движений глаз через Meta Horizon Link

Естественная мимика через Meta Horizon Link

Примечание. Эти функции станут доступны только после включения параметра Developer Runtime Features (Функции разработчика в среде выполнения).

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

Если ваш проект Unity или Unreal уже открыт, после включения функций через Link перезапустите редактор.

Тестирование подключения

Подключите гарнитуру с помощью кабеля USB-C и выполните следующие действия в приложении Meta Quest Link:

Выберите Устройства и проверьте, есть ли в списке ваше устройство.

Выберите подключенное устройство и в меню справа выберите Настройка устройства

Выберите Кабель Link и нажмите Продолжить.

На странице Подключите гарнитуру нажмите Продолжить.

На странице Проверьте подключение по кабелю выберите Проверить соединение.

После завершения теста должно появиться сообщение Совместимое подключение.

Для цветной сквозной камеры USB-подключение должно обеспечивать пропускную способность как минимум 2 Гбит/с.

Если после теста появится сообщение Incompatible connection (Несовместимое подключение) или пропускная способность недостаточная, возможно, потребуется выбрать другой кабель USB-C. Используйте кабель Meta Horizon Link⁠, чтобы обеспечить совместимость.

Проверка пропускной способности

Вы можете измерить скорость соединения с помощью тестера скорости USB, встроенного в приложение Meta Quest Link:

В приложении Meta Horizon Link выберите Devices (Устройства).

Выберите подключенное устройство.

Выберите Тест USB, а затем Проверить соединение.

Проверка подключения Link на гарнитуре

Чтобы убедиться, что ваша гарнитура правильно подключена к Link, выполните следующие действия на гарнитуре:

Откройте Settings (Настройки) > System (Система).

Включите доступ рядом с Quest Link.

Базовое использование Link для разработки приложений

Разработчики могут использовать Link в двух режимах:

прямой запуск сцены в редакторе Unity нажатием Play (Воспроизвести)(►);

запуск проекта в виде независимого приложения для ПК.

Независимо от выбранного режима приложение собирает с гарнитуры полные данные отслеживания.

Запуск приложения на ПК через Link в большинстве случаев аналогичен запуску на гарнитуре. При запуске приложения на ПК через Link для режимов воспроизведения в редакторе и запуска в виде автономного приложения вы (как пользователь) видите 3D-экран приложения в окне просмотра гарнитуры. Вы также увидите обычный экран приложения на экране ПК.

Примечание. Обязательно включите поставщика плагина, например OpenXR, в разделе Edit (Редактировать) > Project Settings (Настройки проекта) > XR Plug-in Management (Управление плагинами XR) > Windows, Linux and Mac settings (Настройки для Windows, Linux и Mac).

Отключение датчика приближения

Отключение датчика приближения через Центр разработки Meta Quest (MQDH) — это часть стандартного процесса разработки.

Подключите гарнитуру к компьютеру для разработки.

Откройте MQDH на компьютере.

На левой панели навигации в MQDH выберите Device Manager (Диспетчер устройств).

Выберите свою гарнитуру из списка Devices (Устройства).

В разделе Device Actions (Действия с устройствами) найдите Proximity Sensor (Датчик приближения).

Переместите переключатель в нужное положение, чтобы отключить датчик приближения. После отключения от MQDH датчик приближения остается отключенным в течение 10 минут или в течение времени, указанного в описании настройки.

Сбор журналов Link из редактора Unity и инструмента OculusLogGather

Если вам необходимо получить журналы Link, это можно сделать это через редактор Unity и приложение Oculus.

В редакторе Unity выберите Window (Окно) > General (Общие) > Console (Консоль).

Нажмите Play (Воспроизвести), когда гарнитура находится в режиме PC Link.

Нажмите значок с тремя точками в правом верхнем углу консоли и выберите Open Editor Log (Открыть журнал редактора).

Найдите файл OculusLogGather.exe на жестком диске компьютера. Расположение этого файла зависит от места установки приложения Oculus. Как правило, он находится в папке C:\Program Files\Oculus\Support\oculus-diagnostics.

Запустите файл OculusLogGather.exe.