Подсветка
Игра запрашивает эффекты, но не обращается к GPIO или RS-485.
Capabilities
Проверяйте led_trigger и led_override после server.hello. Отсутствующее поле не означает поддержку. HTML5 методы возвращают ошибку UNSUPPORTED, если capability не объявлена. Игровые очки не должны зависеть от успешности светового эффекта.
Запросы
triggerLed отправляет имя настроенного триггера. setLedOverride задаёт mode, r/g/b/w в диапазоне 0…255 и duration_ms. SDK проверяет форму параметров, но не доказывает поддержку произвольного mode прошивкой. Допустимые режимы и ограничения проверяются по текущей конфигурации платформы.
Очистка
Не отправляйте команды на каждом кадре. Используйте конечную длительность эффектов. После сеанса очищайте собственный override, если соединение ещё открыто. При потере связи безопасное состояние обеспечивает платформа; игра не пытается восстановить его прямым доступом к контроллеру.
Пример кода
Фрагмент интеграции: переменные игрового проекта задаются приложением. Полный запускаемый пример — в Playground.
if (sdk.capabilities.led_trigger) {
await sdk.triggerLed('HIT');
}