motionvector.dev

music_play

SAFETY: changes the UI immediately — starts or stops audio playback in the browser tab, no human confirmation step. Call demo to play a scripted example, guided for untimed practice, take to start a scored "Try alone" round the human plays, or stop to cancel whatever round is active. Requires a lesson already open (music_open_lesson). Any mode other than stop returns {refused: true, reason: "round_active", hint} instead of acting while a round (guided or take) is already active; stop always goes through. Returns immediately without waiting for the round to finish — call music_wait_for with event "take_completed" instead of polling, and only trust lastCompletedTake once phase has returned to idle. Starting sound may need a prior human click on Enable sound; if so the return has needsUserAction: true and started: false instead of starting playback. Demonstration and guided notes are never a human take — only a fully completed take round updates lastCompletedTake.

Page: /air-instruments/

Input schema

{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "mode"
  ],
  "properties": {
    "mode": {
      "enum": [
        "demo",
        "guided",
        "take",
        "stop"
      ],
      "description": "demo: play a scripted demonstration of the phrase, not counted as a human take. guided: start untimed guided practice, not scored. take: start a scored \"Try alone\" round; only a fully completed one becomes lastCompletedTake. stop: cancel whatever round is currently active. Required."
    }
  }
}