AudioSpeakerMode

Description

The speaker configurations that Unity supports.

Unity supports multiple speaker types. Each speaker type has a different number of channels and is suitable for different device types and situations. The operating system (OS) and hardware determine the final output. Unity requests a mode, but the system might override it. Always check the actual mode at runtime.

Note: AudioSpeakerMode configures the global audio output layout for the entire application. It doesn't assign an AudioSource to an individual speaker channel (for example, front left or rear right). To place sounds in the mix, use AudioSource.panStereo for left-right balance on mono or stereo clips, AudioSource.spatialBlend and the source position for 3D spatialization, AudioSource.spread for multichannel clips in speaker space.

The following are common uses for the speaker modes:

• Stereo is the standard default for most applications.
• Use Mono for accessibility reasons.
• Use 5.1 or 7.1 for high-end PC and console setups, home televisions, theaters.
• Use Quad and 5.0 for specific installations.
• Only use Pro Logic if you must support matrix decoding.

Use AudioSettings.GetConfiguration and AudioSettings.Reset to request a speaker mode at runtime. The device might not accept or support your requested speaker mode. In that case:

• On some platforms, Unity automatically reduces the audio channel count (downmixes) to one your device supports.
• On other platforms, Unity runs the device's native channel count.

To set your project's default speaker mode, go to the Audio Manager: go to Edit > Project Settings > Audio and set Default Speaker Mode to your preferred speaker mode.

The following example demonstrates how to check the current speaker mode at runtime.

using UnityEngine;

public class SpeakerModeExample : MonoBehaviour
{
    void Start()
    {
        Debug.Log("Current Speaker Mode: " + AudioSettings.GetConfiguration().speakerMode);
    }
}

Additional resources: AudioSettings, AudioSource.panStereo, AudioSource.spatialBlend, AudioSource.spread, AudioMixer, Audio Manager.

Properties