Внутренняя разработка VORIVOX. Пакет candidate: оставшиеся проверки обозначены в разделе совместимости.
Диагностика
Ищите проблему по слоям: Manifest → установление WebSocket-соединения → жизненный цикл → координаты → производительность → упаковка.
Состояния SDK
| Состояние | Что означает |
|---|---|
| Connecting | чтение manifest и открытие локальное WebSocket-соединение с Launcher |
| Authenticating | отправлен client.hello, ожидается server.hello |
| Connected | Launcher принял игру; можно отправлять game.ready после загрузки контента |
| Ready | игра объявила готовность к началу сеанса |
| Failed | смотрите LastError и событие Error |
Быстрые проверки внутри Unity
sdk.ConnectionStateChanged += s => Debug.Log("Connection: " + s);
sdk.SessionStateChanged += s => Debug.Log("Session: " + s);
sdk.MessageIgnored += (msg, why) => Debug.LogWarning($"{msg}: {why}");
sdk.Error += message => Debug.LogError(message);
Эти сообщения выводятся в Unity Console и в лог сборки. Это первый уровень диагностики и для него не требуется Python или доступ к серверу.
Инструменты из SDK-пакета
Следующие утилиты запускаются локально на компьютере разработчика, если у вас установлен Python 3. Эти инструменты не запускаются на сервере VORIVOX и не требуют доступа к облачной инфраструктуре.
Проверка manifest
Проверяет структуру launch manifest до запуска игры.
python3 tools/validate_launch_manifest.py mock-launch.jsonMock Launcher
Эмулирует сценарии запуска, паузы, остановки и ошибок оборудования без настоящего тира.
python3 tools/mock_launcher.py --scenario device-faultПроверка пакета игры
Проверяет структуру каталога релиза, наличие manifest, медиа и исполняемой сборки.
python3 tools/validate_game_package.py ./releaseЕсли Python не установлен
Используйте встроенный Mock Launcher sample, логи Unity и ручную проверку структуры пакета по документации.
tools/README.mdЧто приложить к отчёту
- версию игры, SDK и Launcher;
- время проблемы и шаги воспроизведения;
- логи игры без
session_token; - скриншот проекции и ожидаемую точку;
- сценарий Mock Launcher, если проблема воспроизводится без оборудования.
validate_game_package.py — вспомогательная проверка прежнего ZIP-формата, а не валидатор внутреннего Cloud-конвейера. Она не заменяет загрузку исходной сборки, серверную канонизацию, QA и публикацию. Подписанный manifest создаёт Cloud.