Version: 2022.3
LanguageEnglish
  • C#

AudioSettings

class in UnityEngine

/

Implemented in:UnityEngine.AudioModule

Suggest a change

Success!

Thank you for helping us improve the quality of Unity Documentation. Although we cannot accept all submissions, we do read each suggested change from our users and will make updates where applicable.

Close

Submission failed

For some reason your suggested change could not be submitted. Please <a>try again</a> in a few minutes. And thank you for taking the time to help us improve the quality of Unity Documentation.

Close

Cancel

Switch to Manual

Description

Controls the global audio settings from script.

Setup speaker output and format.

Static Properties

audioSpatialExperienceDetermines if the Unity app's final mixed audio stream is spatialized.
driverCapabilitiesReturns the speaker mode capability of the current audio driver. (Read Only)
dspTimeReturns the current time of the audio system.
outputSampleRateGet the mixer's current output rate.
speakerMode AudioSettings.speakerMode is deprecated. Use AudioSettings.GetConfiguration and AudioSettings.Reset to adjust audio settings instead.

Static Methods

GetConfigurationReturns the current configuration of the audio device and system. The values in the struct may then be modified and reapplied via AudioSettings.Reset.
GetDSPBufferSizeGet the mixer's buffer size in samples.
GetSpatializerPluginNameReturns the name of the spatializer selected on the currently-running platform.
GetSpatializerPluginNamesReturns an array with the names of all the available spatializer plugins.
ResetChanges the device configuration and invokes the AudioSettings.OnAudioConfigurationChanged 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.
SetSpatializerPluginNameSets the spatializer plugin for all platform groups. If a null or empty string is passed in, the existing spatializer plugin will be cleared.

Events

OnAudioConfigurationChangedA delegate called whenever the global audio settings are changed, either by AudioSettings.Reset or by an external factor 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.

Delegates

AudioConfigurationChangeHandlerA delegate called whenever the global audio settings are changed, either by AudioSettings.Reset 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.