AudioSettings.SetDSPBufferSize
static
function
SetDSPBufferSize(bufferLength:
int,
numBuffers:
int):
void;
static void SetDSPBufferSize(int bufferLength,
int numBuffers);
static
def
SetDSPBufferSize(bufferLength as int,
numBuffers as int)
as void
Parameters
bufferLength |
Is the length of each buffer in the ringbuffer. |
numBuffers |
Is number of buffers. |
Description
Get or set the mixer's buffer size in samples.
Note that setting a new buffersize will reset the audio system (all audio will stop).
For mobiles (iOS devices and Android) the is also settable from the menu 'Audio Settings->Mobile DSP Buffer size'.
The software mixer mixes to a ringbuffer. The size of this ringbuffer is determined here. It mixes a block of sound data every 'bufferlength' number of samples, and there are 'numbuffers' number of these blocks that make up the entire ringbuffer.
Adjusting these values can lead to extremely low latency performance (smaller values), or greater stability in sound output (larger values).
Warning! The 'buffersize' is generally best left alone. Making the granularity smaller will just increase CPU usage (cache misses and DSP network overhead).
Making it larger affects how often you hear commands update such as volumepitch
pan changes.
Anything above 20ms will be noticable and sound parameter changes will be obvious instead of smooth.
Unity chooses the most optimal size by default for best stability, depending on the output type, and if the drivers are emulated or not (for example DirectSound is emulated using waveOut on NT).
It is not recommended changing this value unless you really need to. You may get worse performance than the default settings chosen by Unity.