Работа без оборудования
Mock нужен для воспроизводимых тестов, но не доказывает аппаратную совместимость.
Явная имитация
createMockSdk возвращает sdk и controls. Доступны start, pause, resume, stop, device, hit и disconnect. Mock никогда не создаёт сетевой сокет. Его отправленные сообщения доступны в controls.sent; демонстрационный session_token в журнале скрыт.
Разные уровни проверки
Playground проверяет механику в браузере. Node-тесты проверяют библиотеку. Отдельный wire-тест соединяет библиотеку с SessionHost из реального исходного Launcher. Ни один из этих уровней не заменяет проверку проектора, аудио, физической мишени, installer и поведения kiosk.
Обязательные сценарии
Нет старта до ready; пауза без начисления; resume без сброса; stop без автоперезапуска; потеря сокета; одинаковый shot_id; неправильный manifest; один финальный результат. Для нового mock-сеанса создавайте новый клиент. Не включайте mock по условию catch любой ошибки подключения.
Пример кода
Фрагмент интеграции: переменные игрового проекта задаются приложением. Полный запускаемый пример — в Playground.
controls.start({countdown_ms: 1000});
controls.hit(0.5, 0.5, 'shot-001');
controls.pause('operator_requested');
controls.resume();
controls.device('controller_lost');
controls.stop('device_fault');