t1k:unity:audio:core

Field	Value
Module	`audio`
Version	`2.1.7`
Effort	`medium`
Tools	—

Keywords: audio, mixer, sound, unity audio

How to invoke

/t1k:unity:audio:core

Unity 6000.3.x Audio System

AudioSource — Quick Reference

audioSource.Play();              // Start playback
audioSource.PlayOneShot(clip);   // Play without stopping current
audioSource.spatialBlend = 1f;   // 0=2D, 1=full 3D
audioSource.outputAudioMixerGroup = sfxGroup; // Route to mixer

Key properties: volume (0–1), pitch (0.5–2), loop, minDistance, maxDistance, rolloffMode

→ See references/audio-api.md for full API, AudioListener, AudioMixer, and AudioClip loading.

AudioMixer — Quick Reference

mixer.SetFloat("SFXVolume", -10f);       // dB scale (-80 to 0)
paused.TransitionToAtTime(0.5f);          // Snapshot blend
audioSource.outputAudioMixerGroup = sfxGroup;

Structure: Master → child groups, each with effects chain (reverb, EQ, compressor). Ducking: Add Attenuation to quiet group, link to loud group’s parameter.

Spatial Audio Setup

Place AudioListener on main camera (exactly one per scene)
Set spatialBlend = 1.0f on AudioSource for full 3D
Configure rolloffMode: Logarithmic (realistic), Linear (precise), Custom (curve)

→ See references/audio-api.md for Doppler, attenuation curves, and spectrum analysis.

Music & Pooling

→ See references/music-and-pooling.md for crossfade, layered music, snapshots, and object pool.

Performance Tips

Pool short SFX; limit to max 32 SFX + 2 music sources simultaneously
Compress clips (MP3/Vorbis); stream music (>2 min clips)
Streaming for music: Set Compression Format = Streaming (VAD) in AudioClip importer

Gotchas

AudioSource.Play() on disabled GO: Calling Play() on an AudioSource whose GameObject is inactive does nothing silently. Ensure GO is active first
Mixer snapshot transitions: TransitionTo(0f) is not instant — it still takes one audio thread tick. Use TransitionTo(0.01f) for near-instant, or set exposed parameters directly
3D spatial blend ignored: spatialBlend = 1.0f has no effect without an AudioListener in the scene. Exactly one listener must exist (typically on the main camera)

unity-addressables — Loading audio clips on demand
unity-scene-management — Persistent audio across scenes
unity-mobile — Audio memory optimization
unity-profiling — Audio performance analysis

Reference Files

File	Contents
`references/audio-api.md`	AudioSource, AudioListener, AudioMixer, AudioClip API
`references/music-and-pooling.md`	Music patterns, sound pool, gotchas