Диагностика
Показывайте стадию отказа без раскрытия launch manifest.
Состояния
connection: connecting, authenticating, connected, ready, failed, disconnected. state: idle, running, paused, stopping, completed. Подписывайтесь на error и ignored. ignored сообщает категорию отклонённого сообщения без публикации исходного JSON.
Браузер
Проверьте ES import, MIME type, регистр пути и локальные ресурсы. Открытый WebSocket не равен принятому server.hello. Браузер может блокировать ws:// с HTTPS-страницы: публичный портал не является production-средой запуска.
Журнал
Сохраняйте версию игры, SDK, фазу и очищенный код ошибки. Не копируйте manifest, socket frames или credentials в снимок экрана. SDK.log скрывает известный session_token, но не является универсальным фильтром всех секретов.
Воспроизведение
Повторите сценарий в mock, затем wire-тесте, затем на комплексе. Укажите, на каком уровне возникла ошибка. Не исправляйте транспорт включением demo.
Пример кода
Фрагмент интеграции: переменные игрового проекта задаются приложением. Полный запускаемый пример — в Playground.
sdk.on('connection', state => showConnection(state));
sdk.on('error', error => showError(error.code));
sdk.on('ignored', event => countIgnored(event.reason));