AudioAnalysis

Real-time audio signal analysis attached to any entity that already has an AudioSource, AudioStream, or VideoPlayer. The renderer analyzes the audio frame buffer and writes results back into the component each tick. Scenes read those results to drive visualizers, beat-reactive geometry, audio-driven lights, etc.

Authoring split

The audio-emitting entity (a speaker / radio / video screen) is static and belongs in main-entities.ts with its AudioSource / AudioStream / VideoPlayer component. AudioAnalysis itself is not in the supported declarative list — attach it at runtime in src/index.ts via getEntityOrNullByName. Reactive entities (pulsing cubes, EQ bars) are likewise added in code since their visuals are driven dynamically.

// main-entities.ts — the audio source
dj_speaker: {
  components: {
    Transform: { position: { x: 8, y: 1, z: 8 } },
    AudioSource: { audioClipUrl: 'sounds/track.mp3', playing: true, loop: true, volume: 0.8 }
  }
}