SmartMic Agent Protocol
Local agent integration specification for KaraFun control
Architecture
The SmartMic Agent is a small program that runs on the same computer as KaraFun Player. It receives commands from SmartMic Cloud and translates them into local actions.
SmartMic Cloud
DJ sends commands from Admin Dashboard
Venue Agent (Local PC)
Polls for commands, executes locally
KaraFun Player
Receives keystrokes, plays songs
Available Commands
| Command | Payload | Description |
|---|---|---|
| play | โ | Resume playback |
| pause | โ | Pause playback |
| stop | โ | Stop and reset |
| skip | โ | Skip to next queued song |
| volume_up | โ | Increase volume one step |
| volume_down | โ | Decrease volume one step |
| load_song | {songTitle, songArtist, karafunId} | Load a specific song into the player |
| search | {query} | Open search with the given text |
| playback_status | {status: playing|idle} | Agent reports KaraFun playback state |
SmartMic Agent Protocol v1.0 ยท Questions? Contact Support