AudioSource

Plays short, one-shot sound effects from a WorldObject.

Attach an AudioSource to any object that needs to emit SFX — a player who fires bullets, a door that creaks, a wall that takes damage. Each call to AudioSource.play spawns a fresh, fire-and-forget AudioInstance routed through the AudioEngine's SFX bus, so several voices from the same source can overlap freely (the burst of an automatic weapon, two shots in quick succession).

What "source" means

AudioSource is the host-component analogue of the renderer's Sprite: a thin behavioural component bound to a WorldObject that exposes a tidy play() / stop() surface and hides the audio-graph bookkeeping. The component holds:

• A default asset — the clip most calls play, often the only one.
• Default volume and pan — applied to each voice unless the call site overrides them in AudioSourcePlayOptions.
• The set of voices it has spawned but not yet finished, so it can AudioSource.stop them in bulk or clean them up when the host WorldObject is destroyed.

Spawn vs play

Unlike Music, voices are spawned per-play, not held by the component. AudioSource.play returns the spawned AudioInstance for the rare caller that wants to fade or stop one voice specifically; most callers ignore the return value entirely.

Stereo positioning

AudioSource does not auto-position based on the host's world position — the engine's panning is a manual [-1, 1] knob, not a positional PannerNode model. If you want a sound to follow the host, set AudioSource.pan from your own controller (e.g. interpolate from host.position.x against the camera). A positional/PannerNode-based variant may land later.

const player = world.createObject();
const shoot = game.assets.getAs('gunshot', AudioAsset);

player.addComponentFromFactory(
  'audio',
  (host) => new AudioSource(host, shoot, { volume: 0.6 }),
);

// Later, in the input handler:
player.getComponent<AudioSource>('audio').play();