Audio Dispatcher: AudioSource for Unity DOTS

Triggering standard Unity audio from pure ECS is notoriously difficult. Audio Dispatcher solves this elegantly.

Audio Dispatcher for DOTS is a production-ready, Data-Oriented audio bridging system. It allows your Burst-compiled Jobs to trigger, move, and stop managed AudioSource components without ever touching the Managed Heap or stalling the Main Thread.

Whether you are building a massive RTS, a chaotic Bullet Hell, or a fast-paced Shooter, this tool ensures your audio scales perfectly with your entity count.

🔥 Key Features

• 100% Burst Compatible: Trigger sounds directly from IJobEntity or ISystem.
• Zero GC Allocations: Fully pre-allocated object pools for both One-Shot and Looping sounds.
• No Main Thread Stalls: Uses a Double Buffering Command Architecture. The main thread never waits for your ECS workers.
• Smart Voice Stealing: If your audio pool is full, the system calculates priorities and automatically replaces the quietest/furthest sound.
• Shadow Tracking (Loops): Attach looping sounds (like tank engines) to moving entities. The sound follows the entity and stops automatically when the entity is destroyed, without modifying your core archetypes!
• Stable Hash IDs: Auto-generates C# constants for your audio clips. Reordering your audio database will never break your code.

💻 Developer Friendly (Fluent API)

You don't need to write boilerplate code. Use the included Fluent API to trigger sounds directly inside your Jobs:

// Play a One-Shot sound (like an explosion)
AudioIDs.EXPLOSION.Shot(position)
    .Volume(0.8f)
    .Pitch(1.1f)
    .Apply(writer);
// Play a Looping sound attached to an Entity
AudioIDs.ENGINE_LOOP.Loop(entity)
    .Volume(0.5f)
    .Apply(writer);

📦 What's Included?

• The complete Audio Dispatcher source code (Clean, commented C#).
• A fully functional Tank Battle Demo Scene demonstrating projectiles, moving loops, global entity destruction, and spatial audio routing.
• PDF Documentation & Quick Start Guide.

⚙️ Requirements

• Unity Version: 2022.3 LTS or higher.
• Dependencies: com.unity.entities (1.0.0+), com.unity.burst, com.unity.collections

📚 Documentation

For a deep dive into the architecture, performance benchmarks, and API reference, please visit our GitBook Documentation