Руководство пользователя
Frontline LBVR Launcher
Один понятный экран для запуска арены, управления шлемами, серверами, картами, плейлистами и бронированиями.
Что делает лаунчер
Frontline LBVR Launcher помогает оператору быстро подготовить и провести сеанс. Сложные технические действия спрятаны за понятными кнопками, статусами и подсказками.
Как читать руководство: сначала пройдите короткий путь запуска, затем используйте нужный раздел как справочник. Опасные действия отмечены отдельно.
Короткий путь запуска
ADB — это служебный канал связи со шлемом. Оператору не нужно знать команды. Важно только понимать три состояния: USB подключён, Wi‑Fi ADB работает, доступа нет.
Что нужно заранее
Подготовьте
- Аккаунт Frontline и активный доступ к лаунчеру.
- Интернет для входа, новостей, билдов, подписки и поддержки.
- VR-шлемы с включённым режимом разработчика и подтверждённым USB debugging.
- Один Wi-Fi/LAN для ПК, шлемов и серверов, если используется запуск по сети.
Основные понятия
- Локация — физическая форма площадки.
- Пресет — карта для выбранной локации.
- Плейлист — порядок карт и режимов на сессию.
- Канал билда — Stable, Beta или Tech Demo.
Первый запуск и вход
При первом запуске лаунчер проверяет аккаунт, подписку, версию приложения и лицензионное соглашение.
Примите соглашение.
Без этого лаунчер не продолжит работу.
Войдите в аккаунт.
Лаунчер откроет страницу входа и сам вернётся в приложение после авторизации.
Проверьте доступ.
Если доступ не активен, часть функций будет закрыта.
Поставьте обновление, если оно нужно.
Обязательные обновления ставятся до начала работы арены.
Офлайн-режим
Если интернет пропал, лаунчер может открыть офлайн-режим. Он доступен только при действующей офлайн-лицензии на этом ПК.
Верхние сообщения
| Сообщение | Что означает | Что сделать |
|---|---|---|
| Доступно обновление | Вышла новая версия лаунчера. | Обновить в удобное время. Если обновление обязательное — перед работой. |
| Подписка не активна | Аккаунт не имеет активного доступа. | Оформить или восстановить подписку, затем повторить вход. |
| Нет подключения | Лаунчер не может проверить сервер. | Проверить интернет. При наличии лицензии можно войти офлайн. |
| Премиум-функция | Раздел или действие закрыты текущим тарифом. | Использовать доступные разделы или обновить подписку. |
В настройках можно сменить язык, выйти из аккаунта, выбрать папку загрузки и включить авто‑подключение Wi‑Fi ADB.
Главные разделы
Слева находится навигация. Верхние разделы нужны для работы арены, нижние — для настроек и поддержки.
Разделы
Новости, баннеры и быстрые ссылки Frontline.
Таймер сессии, быстрый запуск, статистика и матчи.
Парк устройств, массовые команды, Wi-Fi ADB, трансляция.
Загрузка билдов, обновления и локальные PC-игры.
Расписание арены, клиенты, залы и статусы заявок.
Форма арены, пресеты карт, плейлисты и рекомендации.
Запуск серверов на ПК и Android-планшетах.
Онлайн-чат, email и Telegram.
Язык, аккаунт, папка загрузки и авто Wi-Fi ADB.
Новости, таймер и быстрый запуск
Здесь оператор смотрит новости, запускает сервер и шлемы, а также контролирует время сеанса.
Главная
- Баннеры показывают важные объявления и переходы по ссылкам.
- Быстрые действия открывают внешние страницы Frontline или справочные материалы.
- Лента новостей показывает последние публикации и обновления.
Панель
- Таймер арены: 15, 30, 45 минут, без лимита или пользовательское время.
- Пауза, продолжение и сброс сеанса.
- Быстрый запуск ПК-сервера, спектатора и шлемов.
- Краткая статистика: шлемы онлайн и устройства с низким зарядом.
Быстрый запуск на панели
| Кнопка | Назначение | Когда использовать |
|---|---|---|
| Запустить сервер | Стартует сервер выбранного канала на ПК. | Перед запуском шлемов. |
| Запустить спектатор | Открывает режим наблюдения за игрой. | Для администратора, экрана трансляции или контроля. |
| Запуск с сохранёнными якорями | Запускает игру на онлайн-шлемах с выбранной локацией. | Когда шлемы уже настроены и готовы к сеансу. |
| Объявить всем | Передаёт голос с микрофона ПК на готовые шлемы. | Для инструктажа или оперативного объявления. |
Перед запуском сервер и шлемы могут запросить локацию. Это нужно, чтобы игра получила правильные пресеты и плейлисты именно для выбранной физической площадки.
Билды, компоненты и локальные игры
В библиотеке скачиваются и обновляются игровые компоненты для ПК, сервера и шлемов.
Основной канал для рабочих арен. Используется по умолчанию.
Тестовая ветка с новыми возможностями. Может содержать ошибки.
Демонстрационный канал для отдельных сценариев и проверок.
Компоненты билда
| Компонент | Где используется | Для чего нужен |
|---|---|---|
| Client APK | VR-шлем | Клиентская часть игры. Устанавливается на шлемы через раздел управления устройствами. |
| Server Windows | ПК | Сервер арены и запуск с ПК. |
| Server Android | Android-планшет | Сервер арены на планшете, если площадка работает без ПК-сервера. |
Основные действия
Установить или обновить билд
Выберите канал, отметьте нужные компоненты и нажмите загрузку. После скачивания лаунчер установит файлы автоматически. Загрузку можно поставить на паузу, продолжить или отменить.
Проверить установленное
В блоке билда отображаются версия, статус, путь установки, наличие обновления и обязательность обновления. Папку установки можно открыть из интерфейса.
Установленные клиенты
Отдельный блок показывает скачанные Client APK по каналам. Отсюда можно открыть папку или удалить клиентский компонент.
Локальные игры
Можно найти PC-игры автоматически, добавить `.exe` вручную, запустить игру, скрыть её из списка или удалить запись из лаунчера.
Если показано обязательное обновление, запуск соответствующего компонента недоступен до обновления. Это защищает арену от несовместимых версий клиента и сервера.
Карточки шлемов и статусы
Раздел показывает все найденные шлемы и сразу помогает понять, какие готовы к игре.
Главные статусы
Шлем доступен для команд.
Шлем известен, но сейчас не отвечает.
На шлеме не подтверждён USB debugging.
На устройстве идёт установка или проверка.
Что смотреть в карточке
| Поле | Значение |
|---|---|
| Готовность | «Готов к игре», «Есть замечания», «Критическая проблема» или «Оффлайн». |
| Заряд | Низкий заряд начинается ниже 35%, критический — ниже 15%. |
| Wi-Fi | Процент сигнала и признак активного Wi-Fi ADB. |
| Версия | Установленная версия игрового клиента на шлеме. |
| Agent | Служебное приложение для связи, статуса и голосового канала. |
| Якоря | Состояние пространственных якорей: успешно, ошибка, подозрение на смещение или потеря. |
Окно управления устройством
Нажмите «Управление» в карточке шлема. В окне будут запуск, установка, сеть, диагностика, трансляция и связь.
Обзор
Сводка по батарее, сети, памяти, версии, последней активности, ADB и Frontline Agent. Используется для быстрой проверки перед сессией.
Управление
Запуск игры в выбранном режиме, остановка, перезапуск, пробуждение экрана, сон, очистка данных, перезагрузка, громкость, яркость, Guardian и датчики.
Установка
Установка или обновление Client APK из выбранного канала, ручная установка APK, очистка данных приложения и удаление клиента.
Диагностика
Проверка батареи, модели, логов Unity, Wi-Fi, статуса процесса и версии. Для технических специалистов доступна произвольная ADB-команда.
Сеть
USB ADB, Wi-Fi ADB, IP, активный транспорт, подключение, переподключение и отключение Wi-Fi ADB.
Приложения, трансляция и связь
Список приложений на шлеме, запуск выбранного приложения, трансляция экрана, переговоры с одним шлемом и настройки качества потока.
Режимы запуска игры
| Режим | Описание |
|---|---|
| Простой запуск | Стандартный запуск клиента Frontline. |
| С якорями Meta | Запуск с пространственными якорями выбранной локации. |
| Из памяти очков | Запуск с данными, сохранёнными на устройстве. |
| Спектатор | Режим наблюдения без участия в игре. |
Команды «Очистить данные», «Удалить APK», «Перезагрузить» и произвольные ADB-команды могут прервать сеанс или сбросить локальные настройки. Используйте их только осознанно.
Служебное приложение на шлеме
Frontline Agent — служебное приложение на шлеме. Оно помогает лаунчеру видеть статус устройства и держать голосовую связь.
Зачем нужен Agent
- Передаёт статус батареи, сети и активности.
- Помогает сохранять голосовую связь со шлемом.
- Позволяет управлять самопробуждением.
- Сообщает о проблемах установки, разрешений и автозапуска.
Мастер настройки
- Проверяет доступ ADB.
- Проверяет наличие APK.
- Устанавливает приложение при необходимости.
- Выдаёт разрешения и настраивает автозапуск.
- Дожидается связи со шлемом.
Состояния Agent
| Состояние | Что означает | Действие |
|---|---|---|
| Online | Agent работает и отвечает. | Шлем готов к расширенному управлению. |
| Starting | Agent запускается или ждёт связь. | Подождать. Если статус не меняется, открыть мастер. |
| Not installed | Agent отсутствует. | Открыть мастер настройки. |
| Error | Нужна проверка APK, разрешений, автозапуска или сети. | Открыть мастер и выполнить подсказки. |
Самопробуждение не включает экран. Оно помогает шлему вовремя восстановить связь с лаунчером перед глубоким сном Android.
Работа со шлемом без USB-кабеля
Wi‑Fi ADB позволяет управлять шлемом без кабеля после первой настройки через USB. Это удобно для арены с несколькими устройствами.
Подключите USB.
Шлем должен быть онлайн, а запрос USB debugging подтверждён на устройстве.
Откройте мастер.
Лаунчер определит IP, включит сетевой режим и проверит доступность.
Отключите USB.
После успешной проверки шлем можно оставить в управлении по сети.
Окно ADB Wi-Fi
Устройства, готовые к настройке
Показывает шлемы, которые сейчас доступны по USB. Для каждого можно открыть мастер первичной настройки.
Ручное подключение по IP
Используется после первичной активации. Можно ввести IP или IP:порт, например 192.168.0.120:5555.
Активные соединения
Показывает устройства, которые уже работают через Wi-Fi ADB, и можно ли убрать USB.
Переподключение
Если шлем пропал из сети, используйте «Переподключить Wi-Fi ADB» или ручное подключение по IP.
Если подключение по IP не появляется, проверьте три вещи: ПК и шлем в одной сети, Wi-Fi включён на шлеме, порт 5555 доступен после первичной настройки.
Команды для нескольких шлемов
Массовые действия запускают одну команду сразу на нескольких шлемах. Отметьте устройства и откройте меню «Массовые действия».
Игровые команды
Обслуживание
Питание
Опасные действия
Ход выполнения
Лаунчер создаёт список выбранных шлемов и запускает операцию.
Каждый шлем получает статус: ожидает, выполняется, успешно или ошибка.
После завершения можно повторить действие только для устройств с ошибкой.
Для запуска игры и сервера лаунчер может запросить выбор локации и сервера. Если запущено несколько серверов, выберите тот, к которому должны подключиться шлемы.
ПК-сервер и сервер на планшете
Раздел показывает серверы для ПК и Android‑планшетов, а также помогает их запускать и обновлять.
ПК Сервер
- Показывает установленные Windows-серверы по каналам.
- Запускает сервер с выбранной локацией.
- Показывает этапы запуска: авторизация, конфигурация, проверка целостности, старт.
- Позволяет остановить запущенный сервер.
Сервер на планшете
- Показывает Android-планшеты, найденные через ADB.
- Устанавливает или обновляет Server Android APK.
- Проверяет установленную версию.
- Запускает и останавливает сервер на планшете.
Выбор сервера
Если одновременно запущено несколько серверов, перед запуском шлемов лаунчер покажет окно выбора. Это предотвращает подключение игроков к неправильному серверу.
| Ситуация | Что видно | Что делать |
|---|---|---|
| Нет серверных билдов | Пустой блок ПК-сервера. | Перейти в Библиотеку и скачать Server Windows. |
| Планшет не найден | Блок «Планшеты не обнаружены». | Подключить Android-планшет по USB и подтвердить доступ. |
| APK не установлен | Статус «Не установлено». | Нажать «Установить на планшет». |
| Версия устарела | Появится действие «Обновить». | Обновить перед запуском. |
Локации, пресеты и плейлисты
Редактор зон связывает реальную площадку с игровыми картами. Сначала создаётся локация, затем пресеты и плейлисты.
Физическая площадка: форма пола, столбы, стартовый угол и описание.
Игровая карта для локации: стены, проёмы, препятствия, спавны и окружение.
Набор записей с режимами, картами и временем матча.
Пресеты сообщества, которые можно добавить к себе и отредактировать.
Порядок настройки арены
Создайте локацию и нарисуйте игровую площадь. Все клетки пола должны быть соединены.
Отметьте столбы и недоступные зоны, если они есть на площадке.
Сгенерируйте пресет: настройте плотность стен, препятствия, проёмы, спавны и окружение.
Создайте плейлист вручную или сгенерируйте несколько вариантов по длительности и разнообразию карт.
Расписание арены
Раздел помогает оператору видеть расписание, добавлять брони и менять их статус.
Список броней
- Фильтр по статусу, залу, дате и клиенту.
- Мини-календарь с датами, где есть брони.
- Сумма, количество игроков, время и зал в одной строке.
- Подробная карточка брони по нажатию на строку.
Новая бронь
- Выберите локацию и зал.
- Выберите дату и свободное время.
- Укажите количество игроков.
- Найдите существующего клиента или внесите нового.
- Добавьте заметку при необходимости.
Статусы бронирований
| Статус | Когда ставить | Следующие действия |
|---|---|---|
| Новая | Заявка создана, но ещё не подтверждена. | Подтвердить или отменить. |
| Подтверждена | Клиент подтвердил посещение. | Начать сеанс, отменить или отметить неявку. |
| В процессе | Игровой сеанс начался. | Завершить или отменить. |
| Завершена | Сеанс проведён. | Закрытое состояние. |
| Отменена | Бронь отменена. | Можно вернуть в «Новую» при ошибке. |
| Неявка | Клиент не пришёл. | Закрытое состояние. |
Подробная настройка локаций, залов, цен и расписаний выполняется в CRM на сайте Frontline. В лаунчере доступна оперативная работа с текущими бронями.
Системные разделы
Эти разделы нужны для настройки лаунчера и связи с поддержкой Frontline.
Настройки
- Язык интерфейса: русский, английский, казахский.
- Аккаунт: email, уровень доступа и выход из аккаунта.
- Авто Wi-Fi ADB: подключение шлемов по сети при USB-подключении.
- Папка загрузки: место для скачивания билдов.
- О программе: версия, разработчик и год.
Поддержка
- Онлайн-чат Frontline внутри лаунчера.
- Перезагрузка виджета чата, если он не открылся.
- Email: support@frontlinevr.io.
- Telegram как резервный канал.
- Статус операторов: онлайн или офлайн-форма.
Когда обращаться в поддержку
Сообщите канал билда, версию и этап, на котором остановился запуск.
Укажите модель, способ подключения, IP и статус USB debugging.
Приложите текст ошибки установки и версию Client APK.
Укажите локацию, зал, дату и действие, которое не выполняется.
Быстрая диагностика
При проблемах сначала проверьте базовые вещи: питание, сеть, доступ к шлему, установленный билд и выбранную локацию.
| Проблема | Вероятная причина | Решение |
|---|---|---|
| Шлем не появляется | Нет USB, не подтверждён USB debugging или устройство в другой сети. | Подключить USB, подтвердить запрос на шлеме, проверить Wi-Fi. |
| Статус «Нет доступа» | Android видит шлем, но ADB не авторизован. | Надеть шлем и подтвердить доверие к компьютеру. |
| Wi-Fi ADB не подключается | Не было первичной настройки, другой IP или закрыт порт 5555. | Повторить мастер по USB или вручную подключить по актуальному IP. |
| Игра не запускается на шлеме | Нет Client APK, неправильный канал или сервер не выбран. | Установить Client APK, выбрать канал, запустить сервер. |
| Сервер просит локацию | Не выбрана физическая площадка для пресетов. | Выбрать существующую локацию или создать её в редакторе зон. |
| Нельзя сохранить локацию | Пустая сетка или есть разорванные «острова» пола. | Нарисовать соединённую область пола. |
| Низкий заряд | Шлем ниже рабочего порога. | Поставить на зарядку до начала сеанса. |
| Якоря потеряны или подозрительны | Сместилось окружение или шлем не смог корректно загрузить якоря. | Проверить выбранную локацию, перезапустить запуск с якорями, при необходимости пересоздать якоря. |
Короткий словарь
Канал управления Android-устройством с компьютера.
Тот же канал управления, но по локальной сети без USB.
Системная граница безопасности Meta Quest.
Пространственные точки, по которым игра привязывает виртуальную арену к физической.
Игровой клиент, который устанавливается на VR-шлем.
Компонент, который ведёт матч и синхронизирует игроков.
Перед, во время и после сеанса
Эти чек‑листы помогают оператору спокойно провести сеанс от подготовки до завершения.
Перед первым сеансом дня
- Войти в аккаунт и убедиться, что нет обязательного обновления.
- Проверить папку загрузки и наличие нужного билда.
- Подключить шлемы и дождаться статуса «Готов к игре».
- Проверить заряд и Wi-Fi ADB.
- Убедиться, что Frontline Agent онлайн.
- Выбрать правильную локацию.
Запуск сеанса
- Открыть «Панель» и выставить таймер.
- Запустить сервер нужного канала.
- При необходимости запустить спектатор.
- Запустить шлемы выбранным режимом.
- Проверить, что игра запущена на всех участниках.
- Начать таймер арены.
Во время сеанса
- Следить за таймером и статусом шлемов.
- Использовать трансляцию для проверки отдельного игрока.
- Использовать переговоры или объявление всем при необходимости.
- Не выполнять очистку данных и перезагрузку без причины.
После сеанса
- Остановить игру на шлемах.
- Остановить сервер, если он больше не нужен.
- Поставить шлемы на зарядку.
- Обновить статус брони: завершена, отменена или неявка.
- Отметить проблемы для поддержки, если они повторяются.
Для стабильной работы арены используйте Stable-канал как основной. Beta и Tech Demo лучше проверять отдельно от рабочих сессий.