# AudioSettings

> Controls the global audio settings from script.

## Definition

* **Type:** Class
* **Namespace:** [UnityEngine](/engine/6000.7/script-reference/unityengine.md)
* **Assembly:** UnityEngine.AudioModule

```csharp
public sealed class AudioSettings
```

## Remarks

Setup speaker output and format.

## Static Properties

| Property                                                                                                      | Description                                                                                                                                                                                                                                                                                    |
| ------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [audioSpatialExperience](/engine/6000.7/script-reference/unityengine/audiosettings/audiospatialexperience.md) | Determines if the Unity app's final mixed audio stream is spatialized.                                                                                                                                                                                                                         |
| [driverCapabilities](/engine/6000.7/script-reference/unityengine/audiosettings/drivercapabilities.md)         | Returns the speaker mode capability of the current audio driver. (Read Only)                                                                                                                                                                                                                   |
| [dspTime](/engine/6000.7/script-reference/unityengine/audiosettings/dsptime.md)                               | Returns the current time of the audio system.                                                                                                                                                                                                                                                  |
| [outputSampleRate](/engine/6000.7/script-reference/unityengine/audiosettings/outputsamplerate.md)             | Get the mixer's current output rate.                                                                                                                                                                                                                                                           |
| [speakerMode](/engine/6000.7/script-reference/unityengine/audiosettings/speakermode.md)                       | `AudioSettings.speakerMode` is deprecated. Use [AudioSettings.GetConfiguration](/engine/6000.7/script-reference/unityengine/audiosettings/getconfiguration.md) and [AudioSettings.Reset](/engine/6000.7/script-reference/unityengine/audiosettings/reset.md) to adjust audio settings instead. |

## Static Methods

| Method                                                                                                              | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| ------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [GetConfiguration](/engine/6000.7/script-reference/unityengine/audiosettings/getconfiguration.md)                   | Returns the current configuration of the audio device and system. The values in the struct may then be modified and reapplied via [AudioSettings.Reset](/engine/6000.7/script-reference/unityengine/audiosettings/reset.md).                                                                                                                                                                                                                                                                          |
| [GetDSPBufferSize](/engine/6000.7/script-reference/unityengine/audiosettings/getdspbuffersize.md)                   | Get the mixer's buffer size in samples.                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| [GetSpatializerPluginName](/engine/6000.7/script-reference/unityengine/audiosettings/getspatializerpluginname.md)   | Returns the name of the spatializer selected on the currently-running platform.                                                                                                                                                                                                                                                                                                                                                                                                                       |
| [GetSpatializerPluginNames](/engine/6000.7/script-reference/unityengine/audiosettings/getspatializerpluginnames.md) | Returns an array with the names of all the available spatializer plugins.                                                                                                                                                                                                                                                                                                                                                                                                                             |
| [Reset](/engine/6000.7/script-reference/unityengine/audiosettings/reset.md)                                         | Changes the device configuration and invokes the [AudioSettings.OnAudioConfigurationChanged](/engine/6000.7/script-reference/unityengine/audiosettings/onaudioconfigurationchanged.md) delegate with the argument `deviceWasChanged=false`. There's no guarantee that the exact settings specified are used, but Unity automatically uses the closest match that it supports. **Note:** This can cause main thread stalls if `AudioSettings.Reset` is called when objects are loading asynchronously. |
| [SetSpatializerPluginName](/engine/6000.7/script-reference/unityengine/audiosettings/setspatializerpluginname.md)   | Sets the spatializer plugin for all platform groups. If a null or empty string is passed in, the existing spatializer plugin will be cleared.                                                                                                                                                                                                                                                                                                                                                         |

## Static Events

| Member                                                                                                                  | Description                                                       |
| ----------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------- |
| [OnAudioConfigurationChanged](/engine/6000.7/script-reference/unityengine/audiosettings/onaudioconfigurationchanged.md) | Unity calls this event whenever the global audio settings change. |

## Classes

| Class                                                                                       | Description                                                                                  |
| ------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------- |
| [AudioSettings.Mobile](/engine/6000.7/script-reference/unityengine/audiosettings/mobile.md) | This class encapsulates properties and methods to handle audio output thread on iOS/Android. |

## Delegates

| Delegate                                                                                                                                      | Description                                                                                                                                                                                                                                                                                                                                                                  |
| --------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [AudioSettings.AudioConfigurationChangeHandler](/engine/6000.7/script-reference/unityengine/audiosettings/audioconfigurationchangehandler.md) | A delegate called whenever the global audio settings are changed, either by [AudioSettings.Reset](/engine/6000.7/script-reference/unityengine/audiosettings/reset.md) or by an external device change such as the OS control panel changing the sample rate or because the default output device was changed, for example when plugging in an HDMI monitor or a USB headset. |