Документация

Введение

Лаунчер – служебная утилита для запуска сервера, проверки и установки новых обновлений.

Установка и вход в систему

Скачать последнюю версию лаунчера можно здесь. Пароль к архиву: ARCHIVE_PASSWORD

При первом запуске лаунчера необходимо сначала авторизироваться, введя e-mail и пароль от учётной записи. На указанный e-mail приходит проверочный код, который действует 5 минут с момента отправки.

После входа автоматически скачиваются серверное и клиентское приложения. В интерфейсе серверного приложения отобразится предупреждение об обновлении для шлемов, когда установка полностью закончится. Нужно будет сохранить файл этого обновления на рабочем столе, чтобы можно было установить его на шлемы. Установка .apk файла на шлемы выполняется через программу SideQuest. Подробнее про это в этом разделе.

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

....

Это полезно, если их загрузка началась именно тогда, когда игроки уже ждут начала сессии. Особенно в случаях, когда выходит обновление клиентского приложения, которое необходимо будет вручную установить на все шлемы, иначе нельзя будет присоединяться к игровым сессиям из-за устаревшей версии.

Запуск

При запуске ServerLauncher.exe открывается основная программа – серверное приложение. В первые секунды запуска ланчера можно заметить надпись:

....

В редких случаях может понадобиться к ним обратиться. Ниже указаны команды с их назначением:

1. ... очистка всех настроек и данных об авторизованной учетной записи с компьютера. После выполнения этой команды будут удалены все компоненты (сервеное приложение и .apk файл клиентского приложения), останется только ServerLauncher.exe;
2. ... удаление и повторное скачивание всех компонентов системы с сохранением учетной записи;
3. ... команда заменяет используемое доменное имя хостинга на новое для всех программ. Она нужна на случай если домен по каким-либо причинам изменится;
4. ... по умолчанию обновления проверяются только раз в день. Вызов этой команды выполняет принудительную проверку всех компонентов системы на актуальность и автоматически обновляет устаревшие версии;
5. ... команда отменяет текущий выбор.

Возможные проблемы

Ошибка: ...

Ошибка некритичная и означает, что лаунчер не смог соединиться с хостингом для проверки обновлений. Для устранения необходимо подключить компьютер к интернету.

Ошибка: ...

Эта ошибка возникает, когда лаунчер не может найти исполняемый файл серверного приложения или файлы приложения повреждены. Для устранения перезагрузите компьютер. Если проблема сохраняется, переустановите серверное приложение. Для этого выйдите из учётной записи через команду «удалить все данные» в списке доступных команд лаунчера и авторизуйтесь заново. После повторной авторизации лаунчер автоматически загрузит и установит все программы.

Ошибка: ...

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

Ошибка: ...

При возникновении этой ошибки необходимо связаться с разработчиком для ее решения, приложив скриншот ее описания.

Введение

Серверное приложение – это центральный компонент системы, управляющий подключением игроков к квестам, хранением и передачей данных об игровых сессиях, а также доступом к обновлениям клиентских приложений. Он отвечает за создание сессий и корректное их функционирование: переходы между уровнями, учёт времени, статистика и т.д.

Сервер рекомендуется держать постоянно подключённым к интернету для своевременной синхронизации с хостингом и передачи информации об игровых сессиях.

Для тарифов типа «Гибкий» постоянное подключение к сети обязательно, поскольку информация о каждой игровой сессии передаётся на сервер для расчёта стоимости использования. При отсутствии подключения к интернету работа серверного приложения по таким тарифам невозможна.

Для тарифов по подписке постоянное подключение к интернету не требуется. Серверное приложение может работать без доступа к сети, однако период отсутствия подключения не должен превышать 3 дня. По истечении этого срока доступ к серверному приложению может быть автоматически ограничен до восстановления соединения с интернетом и проведения синхронизации.

Использование

Меню

1. Квест: список всех доступных квестов;
2. Количество игроков: целевое количество подключаемых шлемов;
3. Создание сессии: открывает клиентским приложениям возможность подключиться к серверному приложению с выбранными параметрами;
4. Включение/отключение телепортации: функция, предназначенная только для тестовых запусков. Включение телепортации нарушит синхронизацию положений игроков в пределах одной комнаты. В рабочем режиме функция должна оставаться выключенной, как задано по умолчанию;
5. Включение/отключение подсказок: позволяет настроить отображение внутриигровых подсказок на локациях квеста. Используется, если игроки хотят проходить квест самостоятельно. По умолчанию подсказки включены;
6. Получение клиентского приложения: после нажатия на рабочий стол копируется .apk файл последней загруженной версии клиентского приложения, который загружается на шлем. Подробнее про загрузку обновлений на шлем в этом разделе;
7. Переход в личный кабинет: можно открыть в браузере на ПК или зайти с телефона по QR-коду. В кабинете доступна информация о сессиях и документация.
8. Информация о лицензии: отображает текущий статус подключения к сети, почту аккаунта, активный тариф, баланс, срок действия лицензии и оставшееся время работы в оффлайн-режиме.

Создание сессии и подключение шлемов

После выбора квеста и параметров необходимо нажать кнопку «Создать сессию». На экране появится список доступных IP-адресов:

Панель списка игроков и уровней

Подключённые игроки отображаются в левой части окна. Для каждого шлема указываются:

• Номер устройства: задается вручную и используется, чтобы различать друг от друга игроков в списке;
• Процент заряда батареи: при падении ниже установленного порога отображается сообщение о низком заряде, необходимо подключить внешний аккумулятор;
• Статус питания: показывает, подключён ли внешний аккумулятор;
• Индикатор уровня звука микрофона: визуализирует уровень громкости голоса в реальном времени;
• Пинг: указывает текущее время отклика между клиентским и серверным приложениями.

Кликнув по игроку из списка открывается окно с подробной информацией о подключённом шлеме:

В этой панели можно изменить номер шлема или удалить игрока из сессии.

Работа с игровыми зонами

Когда все игроки подключены, можно нажать кнопку «Отобразить зоны». Зоны можно включить и раньше – до подключения всех игроков.

Цветовые индикаторы и их обозначение:

• Оранжевый – ожидание подтверждения завершения загрузки уровня;
• Красный – игрок находится вне назначенной зоны;
• Синий – игрок правильно расположен в зоне;
• Зелёный – игрок в сети;
• Серый – игрок не отвечает серверу.

Запуск и управление игровым процессом

Кнопка «Начать» запускает первый уровень квеста. Над кнопкой находится шкала времени, показывающая оставшееся время на прохождение уровня:

Переход между уровнями происходит автоматически:

• после успешного прохождения текущей локации;
• по истечении отведённого времени.

Завершение игры

После прохождения последнего уровня игроки автоматически попадают на финальную локацию с присвоением игровых псевдонимов. Можно попасть туда вручную, нажав кнопку «Показать итоги».

Возможные проблемы

Не отображаются доступные IP-адреса

Если IP-адреса не отображаются, проверьте подключение к сети Wi-Fi.

Введение

Клиентское приложение – это программа для VR шлема Oculus Quest 2, через которую игроки проходят головоломки и выполняют задачи, синхронизируясь с серверным приложением.

Первичная настройка

Чтобы все игроки видели виртуальный мир одинаково и их позиции совпадали относительно друг друга, используется система с двумя точками A и B, расположенными на полу. Их нужно назначать в клиентском приложении каждый раз, когда формируется новая граница.

При назначении точек система автоматически вычисляет середину между ними и принимает её за центр игровой комнаты. Также из точек формируется общее направление для всех шлемов. В приложении направление отображается стрелкой на север (N).

В стандартном режиме с включённой границей (Guardian/Boundary) назначение точек требуется только при создании новой зоны. Перед каждой игровой сессией их повторно указывать не нужно.

Также на шлемах Meta Quest есть режим разработчика, в котором можно отключать границу: Разработчик > Функции физического пространства В этом режиме перед каждым запуском сессии нужно заново выполнить привязку пространства: указать точки A и B, а также подтвердить уровень пола. В отличие от режима с границей, эти данные не сохраняются между запусками в стабильном виде и их нужно задавать повторно.

Установка обновлений

Для установки клиентского приложения на Oculus Quest 2 используется утилита SideQuest. Она позволяет загружать APK-файлы напрямую в шлем. Вы можете скачать её здесь.

Для полного контроля процесса загрузки и установки перейдите во вкладку Task Manager:

Здесь можно увидеть журнал операций всех задач:

Возможные проблемы

Кнопка Продолжить неактивна

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

Перед началом игровой сессии необходимо установить громкость устройства на высокий уровень (рекомендуется максимальный). Это сделано намеренно, чтобы исключить ситуацию, когда игроки начинают игру без звука.

Часто приходится настраивать положение точек A и B

Если граница не изменялась, но приложение регулярно просит указать положение точек A и B, скорее всего, это связано с остаточными данными предыдущей разметки пространства. Чтобы решить проблему, рекомендуется очистить историю границ и сканирования пространства, после чего заново создать безопасную зону, как описано в этом разделе.

Зависание на этапе Checking APK against blacklist

Для решения проблемы с зависанием на этапе «Checking APK against blacklist» достаточно отменить текущую загрузку, которая застряла, и повторить установку приложения заново – в большинстве случаев этого хватает, чтобы процесс прошёл успешно.

Установка .apk через ADB вручную

Иногда SideQuest может упорно выдавать ошибки или зависать при установке APK, и стандартные способы не помогают. В таких случаях можно воспользоваться прямой установкой через ADB (Android Debug Bridge).

1. В правом верхнем углу утилиты нажмите кнопку Run ADB Command, затем выберите CUSTOM COMMAND:

   

2. Введите команду для установки APK adb install "путь_к_файлу" Она будет выглядеть как-то так: adb install "C:\Users\USER\Desktop\build-v1.0.0.apk":

   

3. Нажмите RUN COMMAND.

Ошибка: Ошибка подключения

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

Введение

Oculus Quest 2 – это автономный VR-шлем, который используется для проведения квестов и погружения игроков в виртуальную среду.

Первичная настройка шлема

Настройка границы физического пространства

Граница – это встроенная функция безопасности. Она позволяет настроить виртуальные стены, возникающие при приближении к краям игровой зоны.

Перед созданием новой границы на Oculus Quest 2 желательно очистить старую, так как сохранённые данные предыдущей разметки могут вызывать конфликты с новой границей, приводить к дрожанию или смещению визуальной сетки.

Откройте универсальное меню, перейдите в Настройки > Физическое пространство > Очистить историю границ и сканирования пространства.

В том же разделе меню будет кнопка «Создать новую границу». Настройка новой границы:

• Опустите один из контроллеров до упора вниз и подтвердите расстояние до пола;
В первый раз шлем сам попытается определить уровень до пола, но если сетка не опустилась вслед за контроллером, то это означает, что она находится ниже уровня пола. Необходимо нажать на кнопку «Переснять» и заново указать нижнюю границу, иначе игрокам будет проблематично поднимать игровые предметы с пола.
• Нарисуйте границу для игры с перемещением прямоугольной формы на расстоянии не менее 1 м до стен.

Уход за шлемом

Перед каждым игровым сеансом

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

Также необходимо аккуратно протереть датчик расстояния внутри очков, чтобы не повредить поверхность.

Перед тем как надеть на игрока шлем, проверьте, что его громкость установлена на максимуме.

Во время игрового сеанса

Необходимо следить за уровнем заряда шлема во время игры через серверное приложение. В случаях, когда внешняя батарея (PowerBank) разряжена и зарядка не идёт, его следует заменить, чтобы избежать внезапного отключения шлема во время игрового сеанса. Это особенно важно в ситуациях, когда все шлемы используются одновременно, а игровые сессии проходят подряд без возможности поставить устройства на подзарядку. Наличие заряженного PowerBank обеспечивает непрерывную работу шлема и предотвращает внезапное отключение устройства во время игры, что критично для поддержания стабильного игрового процесса и комфортного опыта для игроков.

В конце рабочего дня

Съемную лицевую маску промыть под прохладной водой с жидким моющим средством. Чтобы очистить зазоры вокруг линз, можно обернуть салфетку или ткань вокруг ватной палочки. Для очистки шлема используйте безворсовые салфетки или сухую микрофибровую ткань. Используйте неабразивные антибактериальные салфетки для всего, кроме линз. Снимите съемные детали и очистите их отдельно.

После очистки необходимо поставить все шлемы на зарядку, а также убедиться, что внешние аккумуляторы (PowerBank) подключены к источнику питания. Это гарантирует, что на следующий рабочий день все устройства будут полностью готовы к использованию.

При необходимости

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

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

Возможные проблемы

Ошибка после перезагрузки шлема

После перезагрузции шлем может выдать ошибку «Проверьте подключение и попробуйте еще раз». В этом случае необходимо:

1. Нажать кнопку «Проверить подключение»;
2. Отключить Wi‑Fi;
3. Нажать «Готово».

После выполнения этих действий шлем допустит вас в главное меню, где уже можно будет заново включить Wi‑Fi и подключиться к нужной сети.