Разработка

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

Отладка контента в Browser

На этой странице описаны многочисленные способы отладки работы Browser.

Подключение к устройству

Перед отладкой необходимо подключиться к устройству. Вы можете использовать MQDH, USB или Wi-Fi.

Подключение с помощью Центра разработки Meta Quest

Предпочтительный способ тестирования и отладки контента в Browser — использование Центра разработки Meta Quest (MQDH), в котором есть инструменты для настройки устройства, запуска трансляции и многое другое. Вы можете найти инструкции по настройке MQDH для подключения вашего устройства на главной странице MQDH.

Отладка на Meta Quest по USB без MQDH

Чтобы настроить устройство для отладки по USB:

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

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

Вы не должны быть младше 18 лет.

На вашей гарнитуре нет ограничений на уровне устройства, которые препятствуют включению режима разработчика.

Чтобы включить режим разработчика:

Откройте приложение Meta Horizon на мобильном устройстве.

В приложении нажмите на значок гарнитуры на панели инструментов.

Связанная гарнитура должна появиться в верхней части экрана. Выберите элемент гарнитуры, где будут показаны модель и статус связанной гарнитуры.

Выберите Headset Settings (Настройки гарнитуры) под изображением гарнитуры.

Нажмите Developer Mode (Режим разработчика).

Включите Developer Mode (Режим разработчика) с помощью переключателя.

Toggle Developer Mode to the on position

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

Видео: как включить режим разработчика в приложении Meta Horizon.

Подключите гарнитуру к компьютеру с помощью кабеля USB-C.

Примечание. Чтобы настроить устройство без компьютера, ознакомьтесь с документацией по настройке вашего конкретного устройства в Справочном центре Meta Quest⁠.

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

Откройте на гарнитуре пункт меню Quick Control (Быстрое управление).

Выберите Open Settings (Открыть настройки), что отображается в виде значка шестеренки. Затем откройте вкладку Developer (Разработчик) и включите переключатель MTP Notification (Уведомление MTP).

Когда появится запрос на разрешение отладки через USB, выберите Always allow from this computer (Всегда разрешать с этого компьютера).

После подключения откройте командную оболочку и введите следующую команду:

adb devices

Если устройство подключено правильно, ADB выведет список идентификаторов устройств, например:

List of devices attached
ce0551e7                device

ADB нельзя использовать, если устройство не обнаружено. Если вашего устройства нет в списке, скорее всего, проблема заключается в том, что у вас нет правильного USB-драйвера. Вы также можете попробовать другой USB-кабель и (или) порт.

Просмотр локальных страниц на Quest с помощью ADB Reverse

Используйте ADB Reverse для просмотра на устройстве локальных страниц с компьютера.

Обычный рабочий процесс веб-разработки включает создание на компьютере локального HTTP-сервера, указывающего на порт хоста localhost. Вы можете использовать adb reverse, чтобы сделать эту страницу доступной на устройстве, пока оно подключено к вашему компьютеру.

Для этого выполните команду: adb reverse tcp:8080 tcp:8080.

Подставьте вместо 8080 номер порта, на котором работает ваш HTTP-сервер.

Включение отладки по Wi-Fi

Как правило, подключение к устройству через порт USB работает быстрее, чем через соединение TCP/IP, однако в некоторых случаях соединение TCP/IP незаменимо.

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

Выполните описанную выше процедуру включения отладки по USB, а затем подключите устройство к компьютеру с помощью USB-кабеля.

Установите Android Platform Tools⁠, если вы ещё не установили инструмент adb.

Откройте терминал или окно командной строки Windows.

Найдите инструмент adb, если его ещё нет в вашем пути. В Windows он обычно находится здесь: C:\Users\{user}\AppData\Local\Android\sdk\platform-tools. Затем выполните следующую команду, чтобы определить IP-адрес устройства:

adb shell ip route

Полученный результат должен выглядеть примерно так:

10.0.30.0/19 dev wlan0  proto kernel  scope link  src 10.0.32.101

IP-адрес устройства указан после параметра src. Введите следующие команды, используя этот IP-адрес и порт 5555:

adb tcpip 5555
adb connect *<ipaddress>*:5555

Пример:

> adb tcpip 5555
    restarting in TCP mode port: 5555
> adb connect 10.0.32.101:5555
    connected to 10.0.32.101:5555

После этого устройство можно отключить от порта USB. Пока в adb devices выводится только одно устройство, все команды ADB будут отправляться на это устройство по Wi-Fi.

Чтобы прекратить работу с подключением по Wi-Fi, выполните следующую команду ADB в оболочке ОС:

adb disconnect

Запуск сеанса удаленной отладки с помощью Chrome DevTools

После просмотра сайта на устройстве в Browser вы можете удаленно отладить его с помощью Chrome DevTools.

Чтобы начать сеанс удаленной отладки:

На устройстве откройте Browser и перейдите на свой сайт.

Запустите Google Chrome.

Перейдите по адресу chrome://inspect/#devices.

Найдите свое устройство. Вы увидите набор вкладок Browser, открытых в данный момент на устройстве.

Нажмите inspect (Проверить), чтобы начать отладку вкладки в Browser.

Подробнее об удаленной отладке с помощью Chrome DevTools см. на странице Chrome DevTools — удаленная отладка⁠.

Отладка контента WebXR

Информация на этой странице предназначена для отладки двухмерных и иммерсивных WebXR-приложений в Browser. Информацию о стратегиях отладки, предназначенных только для иммерсивных WebXR-приложений, можно найти в статье Рабочий процесс WebXR.

Дополнительные сведения о настройке устройств и отладке VR-приложений:

Настройка устройства — Meta Quest

Устранение неполадок с подключением ADB

Отладка в Android