Lighting
Games request effects without accessing GPIO or RS-485.
Capabilities
Check led_trigger and led_override after server.hello. A missing field does not mean support. HTML5 methods reject with UNSUPPORTED unless the capability is advertised. Scoring must not depend on successful lighting.
Requests
triggerLed sends a configured trigger name. setLedOverride supplies mode, r/g/b/w channels from 0…255 and duration_ms. The SDK validates parameter shape but cannot prove that firmware supports an arbitrary mode. Verify allowed modes and limits against the current platform configuration.
Cleanup
Do not send commands every frame. Prefer finite-duration effects. Clear your override after the session while the connection remains open. On connection loss the platform owns safe hardware state; the game must not recover it through direct controller access.
Code example
Integration excerpt: game-specific variables belong to the application. Playground contains the runnable reference.
if (sdk.capabilities.led_trigger) {
await sdk.triggerLed('HIT');
}