Emcee experiences

Emcee Controller

The Emcee Controller is NextWave's fullscreen live tool, served at /emcee/. It puts a member-aware display on the big screen and gives you, the host (or your agent), control over what it shows. The display renders whatever state you push to it — so instead of clicking through a UI mid-event, you can drive the room programmatically.

The model is small: you take control of the display, set its state, and read it back.

Built-in experiences

NextWave ships five live experiences out of the box:

Extension experiences

The Emcee Controller is extensible. Add-on experiences live in their own plugins and register into the controller through the emcee hook contract — the same selector grid, the same state-driven display, but with their own logic and their own REST namespace.

When an extension is installed it appears in the experience selector alongside the built-ins and is driven the same way — you set the display state to its slug and the extension takes over rendering. The hook contract is what lets a separate plugin slot cleanly into the controller without modifying NextWave core.

Driving experiences via the API

Three operations cover the whole loop. First, take control of the display so your commands own what's on screen:

$ nwp emcee take-control --output json

Then set the state — choose an experience and a phase. Here we put Would You Rather into its running phase:

$ nwp emcee set-state --phase running --experience would-you-rather --output json

Read it back any time with get-state to see exactly what the display is rendering:

$ nwp emcee get-state --output json

{
  "success": true,
  "data": {
    "phase": "running",
    "experience": "would-you-rather",
    "ext": {
      "bingo": null
    }
  }
}

The full operation set:

• take-control — claim the display for your session.
• set-state — push a phase + experience to the screen.
• get-state — read the current display state.
• clear-state — reset the display back to idle.