Skip to content
Task guideDevelopmentEngine ccf7d03f

A mixer groups voices under semantic buses and routes them toward the mandatory master bus. Build a complete immutable graph, validate it, then hand it to the host or mixer-extension boundary that owns installation.

This Runtime-script helper produces configuration only. It does not mutate the active device, promise a built-in mixer editor, or install a graph implicitly.

using InnoEngine.Audio;
public static class MusicMixer
{
public static AudioMixer Create()
{
AudioMixerBuilder builder = new();
AudioBusId music = new("music");
builder.AddBus(music, AudioBusId.master, volume: 0.8f);
builder.AddProcessor(music, new AudioProcessorConfiguration(
AudioProcessorId.lowPass,
new[] { new AudioProcessorParameter(AudioParameterId.frequency, 12000f) }));
return builder.Build();
}
}

Choose stable bus identities and use them in validated playback options. AddBus rejects duplicate or invalid identities. Build rejects missing parents and cycles, returning parent-before-child order. Processor chains preserve their declared order. Configuration uses finite values and the processor’s applicable parameter contract.

A host uses the runtime’s mixer installation API; a reloadable mixer extension supplies configuration through its declared generation. A failed candidate must leave the last valid mixer usable when candidate cleanup succeeds. Installation is not an instruction to free buses that existing voices still use.

Bus volume, mute and pause are runtime controls. A replacement device reconstructs the current graph and its control state before publication. Application suspension pauses the relevant masters without erasing an explicit user pause. See mixer generations and suspension.

Standard IDs cover common filters and delay. Plugin-specific processors use explicit IDs and a backend that implements them; an open ID is not a guarantee of support. Persist extension identity and neutral serialized configuration, never plugin types, delegates or live instances.

This boundary does not expose a managed real-time DSP callback. Advanced DSP, recording, VOIP, occlusion and gameplay music policy require separately implemented extensions; they are not implied by the mixer graph.