Как настроить Meta* Quest 2 для тестирования и сбора логов

Найти в интернете актуальные инструкции по подключению Meta* Quest 2 (Oculus Quest 2) к Android Debug Bridge непросто. Алиса Мордвинова, QA-специалист IT Test, на практике столкнулась с этой проблемой и совместно с Unity-разработчиком Даниилом Галаховым создала собственный туториал для тестировщиков, которые работают с VR-шлемами Meta*.

Последняя релевантная информация о способах «взлома» VR-шлемов датируется 2016 годом — именно тогда Oculus стал набирать популярность. С тех пор внутреннее устройство этого девайса ощутимо изменилось, как и способы проникновения в его систему. Раньше Oculus подключался к компьютеру через провод, и приложение устанавливалось на ПК, сейчас же оно загружается на внутренние носители шлема, которые имеют свою систему защиты.
⠀

Для того, чтобы в процессе тестирования не превратить Meta* Quest 2 в «кирпич», нужно соблюдать меры предосторожности.

Не устанавливайте на VR-шлем Sideload и подобные пиратские приложения, которые ломают защитную систему устройства, — они могут повредить его программное обеспечение. Заблокировать шлем таким образом довольно просто, а восстановить его не удастся. Вместо этого стоит использовать ADB Driver — он позволяет делать отладку и смотреть внутрянку, но ничего не ломает и делает логи открытыми.

Не игнорируйте настройку Meta*-аккаунта, включая установку аватара, — без этого система не даст работать дальше. Если скипать шаги в настройке, то появится ошибка, которую будет сложно обойти из-за технических нюансов процесса.

Используйте в работе только оплаченный VPN. Если Мeta* заметит использование бесплатных приложений, то может заблокировать аккаунт, восстановить который будет невозможно. Единственный выход в такой ситуации — создавать новый профиль.
Следите за зарядом батареи шлема и контроллеров — они быстро садятся и за ночь в простое могут разрядиться полностью. Устройства нужно обязательно выключать или держать на подзарядке.

Пошаговая инструкция

Получите доступ к VPN для ПК и смартфона, чтобы зарегистрировать Meta*-аккаунт.
Скачайте с официального сайта ПО для Meta* Quest 2 и установите его на компьютер. Приложение будет сообщать о недостаточной мощности ПК — это нормально.
Установите на смартфон официальное приложение Meta* Quest 2. Не забудьте включить при этом VPN и геопозицию — без этого приложение не будет работать.
Создайте Meta*-аккаунт, выполнив все предложенные шаги по его настройке.
Активируйте шлем, примените настройки. Свяжите устройство с телефоном и Meta*-аккаунтом, подключитесь к Wi-Fi. Если шлем зависнет на этапе обновления, то попробуйте подключить девайс к интернету с телефона через точку доступа.

На крайний случай можно сбросить шлем до фабричных настроек, одновременно удерживая кнопки питания и уменьшения громкости. Внутри появится меню, а в нем — функция «factory reset». В практике бывали случаи, когда обновление шлема затягивалось на всю ночь: он до утра лежал включенным и только затем обновился. Будьте готовы к таким ситуациям.
Когда шлем будет связан с телефоном, перейдите в раздел профиля «Настройки гарнитуры» и активируйте там «Режим разработчика». Делать это нужно каждый раз перед связыванием с ADB — без этого шлем не получится найти.

Для активации «Режима разработчика» в Meta*-аккаунте необходимо заполнить данные раздела «Профиль» через браузер ПК.
Найдите под пунктом «Имя пользователя» раздел «Центр аккаунтов» и кнопку «Управлять». Кликните по ней, чтобы перейти в «Аккаунт Meta*» и выберите пункт «Пароль и безопасность».

В этом разделе находится «Двухфакторная аутентификация» со значением по умолчанию «ВЫКЛ». Кликните по кнопке «Редактировать» и настройте аутентификацию по SMS или выберите другой способ.
Активируйте переключатель «Режим разработчика» на девайсе в приложении Meta Quest 2 (Oculus). В смартфоне будет указано, что для включения этого режима нужно создать компанию или добавиться к существующей. Перейдите по ссылке, которую предложит приложение, и создайте случайную несуществующую компанию. После этого переключатель станет доступен.
Скорректируйте настройки шлема. В разделе «Настройки» → «Система» → «Для разработчиков» разрешите установку и выполнение приложений из Unknown sources, USB-подключения и обмен файлами с компьютером. В некоторых версиях операционной системы шлема этого может не быть, так как все становится доступным сразу при подключении режима разработчика.
Настройте рабочую область согласно инструкции, которую предложит шлем. Выберите пустое пространство для движения без проводов под ногами примерно три на три метра.
Скачайте Platform Tools для Android.
Снова подключите шлем к ПК и найдите его с помощью ADB Devices. Причины, по которым обычно не удается обнаружить шлем:

—включен антивирус и firewall;
—запущена программа Android Studio —на данном этапе это не нужно;
—не установлен драйвер Oculus-adb-driver-2.0.zip.

Установить его можно через «Диспетчер устройств». Если система сообщает, что установила что-то более подходящее, то загрузите драйвер принудительно:

—выделите Meta* Quest 2 (Oculus), затем в верхнем меню «Диспетчера устройств» кликните по вкладке «Действие» → «Добавить драйверы» и установите нужный;
—если система снова повторяет, что установила более подходящий вариант, то в крайнем случае кликните правой кнопкой мыши по Meta* Quest 2 (Oculus) и выберите «Удалить устройство». После этого установите нужные драйверы на «Видеоадаптеры».
Запустите PowerShell из папки Platform-tools, но при этом не давайте доступ к данным в шлеме. Введите команду adb devices — она должна найти устройство. Если система сообщает:

* daemon not running; starting now at tcp:5037
* daemon started successfully
List of devices attached

или что-то похожее, то попробуйте несколько вариантов исправления.

—Проверьте, что режим разработчика активен на смартфоне и шлеме.
—Переподключите провод шлема и снова введите команду adb devices.
—Если это не помогло, попробуйте использовать другой разъем USB 3.0, шлем при этом должен быть включен.
—Перезапустите «демона» с помощью команд:

adb kill-server
adb start-server
adb usb

—Перезапустите шлем с помощью перезагрузки и/или используйте «включить/выключить».
Установите нужное вам приложение с помощью команды

adb install -g -r <полный_путь_до_.apk>

Не используйте пробелы в названиях папок в пути и по возможности применяйте латинские символы.
Перейдите в шлеме в раздел «Библиотека приложений», чтобы запустить файл из Unknown sources. В фильтрации «Все (кол-во)» выберите «Неизвестные источники (кол-во)» и запустите приложение.

Meta* Quest 2 готов для тестирования и сбора логов. Пишите вопросы по настройке в комментариях — поможем разобраться.

Больше экспертных материалов о заказной разработке, дизайне и тестировании в Telegram-канале IT Test.

Перейти в Telegram-канал

*Компания Meta признана экстремистской организацией, и ее деятельность запрещена на территории РФ.