Class AudioServerInstance

Namespace

Godot

Assembly

GodotSharp.dll

AudioServer is a low-level server interface for audio access. It is in charge of creating sample data (playable audio) as well as its playback via a voice interface.

[GodotClassName("AudioServer")]
public class AudioServerInstance : GodotObject, IDisposable

Inheritance

object

GodotObject

AudioServerInstance

Implements

IDisposable

Inherited Members

GodotObject.NotificationPostinitialize

GodotObject.NotificationPredelete

GodotObject.NotificationExtensionReloaded

GodotObject.InstanceFromId(ulong)

GodotObject.IsInstanceIdValid(ulong)

GodotObject.IsInstanceValid(GodotObject)

GodotObject.WeakRef(GodotObject)

GodotObject.Dispose()

GodotObject.Dispose(bool)

GodotObject.ToString()

GodotObject.ToSignal(GodotObject, StringName)

GodotObject._Get(StringName)

GodotObject._GetPropertyList()

GodotObject._Notification(int)

GodotObject._PropertyCanRevert(StringName)

GodotObject._PropertyGetRevert(StringName)

GodotObject._Set(StringName, Variant)

GodotObject._ValidateProperty(Dictionary)

GodotObject.Free()

GodotObject.GetClass()

GodotObject.IsClass(string)

GodotObject.Set(StringName, Variant)

GodotObject.Get(StringName)

GodotObject.SetIndexed(NodePath, Variant)

GodotObject.GetIndexed(NodePath)

GodotObject.GetPropertyList()

GodotObject.GetMethodList()

GodotObject.PropertyCanRevert(StringName)

GodotObject.PropertyGetRevert(StringName)

GodotObject.Notification(int, bool)

GodotObject.GetInstanceId()

GodotObject.SetScript(Variant)

GodotObject.GetScript()

GodotObject.SetMeta(StringName, Variant)

GodotObject.RemoveMeta(StringName)

GodotObject.GetMeta(StringName, Variant)

GodotObject.HasMeta(StringName)

GodotObject.GetMetaList()

GodotObject.AddUserSignal(string, Array)

GodotObject.HasUserSignal(StringName)

GodotObject.EmitSignal(StringName, params Variant[])

GodotObject.Call(StringName, params Variant[])

GodotObject.CallDeferred(StringName, params Variant[])

GodotObject.SetDeferred(StringName, Variant)

GodotObject.Callv(StringName, Array)

GodotObject.HasMethod(StringName)

GodotObject.HasSignal(StringName)

GodotObject.GetSignalList()

GodotObject.GetSignalConnectionList(StringName)

GodotObject.GetIncomingConnections()

GodotObject.Connect(StringName, Callable, uint)

GodotObject.Disconnect(StringName, Callable)

GodotObject.IsConnected(StringName, Callable)

GodotObject.SetBlockSignals(bool)

GodotObject.IsBlockingSignals()

GodotObject.NotifyPropertyListChanged()

GodotObject.SetMessageTranslation(bool)

GodotObject.CanTranslateMessages()

GodotObject.Tr(StringName, StringName)

GodotObject.TrN(StringName, StringName, int, StringName)

GodotObject.IsQueuedForDeletion()

GodotObject.CancelFree()

GodotObject.NativeInstance

GodotObject.ScriptChanged

GodotObject.PropertyListChanged

object.GetType()

object.MemberwiseClone()

object.Equals(object)

object.Equals(object, object)

object.ReferenceEquals(object, object)

object.GetHashCode()

Properties

BusCount

Number of available audio buses.

public int BusCount { get; set; }

Property Value

int

InputDevice

Name of the current device for audio input (see GetInputDeviceList()). On systems with multiple audio inputs (such as analog, USB and HDMI audio), this can be used to select the audio input device. The value "Default" will record audio on the system-wide default audio input. If an invalid device name is set, the value will be reverted back to "Default".

Note: ProjectSettings.audio/driver/enable_input must be true for audio input to work. See also that setting's description for caveats related to permissions and operating system privacy settings.

public string InputDevice { get; set; }

Property Value

string

OutputDevice

Name of the current device for audio output (see GetOutputDeviceList()). On systems with multiple audio outputs (such as analog, USB and HDMI audio), this can be used to select the audio output device. The value "Default" will play audio on the system-wide default audio output. If an invalid device name is set, the value will be reverted back to "Default".

public string OutputDevice { get; set; }

Property Value

string

PlaybackSpeedScale

Scales the rate at which audio is played (i.e. setting it to 0.5 will make the audio be played at half its speed).

public float PlaybackSpeedScale { get; set; }

Property Value

float

Methods

AddBus(int)

Adds a bus at atPosition.

public void AddBus(int atPosition = -1)

Parameters

atPosition int

AddBusEffect(int, AudioEffect, int)

Adds an AudioEffect effect to the bus busIdx at atPosition.

public void AddBusEffect(int busIdx, AudioEffect effect, int atPosition = -1)

Parameters

busIdx int

effect AudioEffect

atPosition int

GenerateBusLayout()

Generates an AudioBusLayout using the available buses and effects.

public AudioBusLayout GenerateBusLayout()

Returns

AudioBusLayout

GetBusChannels(int)

Returns the number of channels of the bus at index busIdx.

public int GetBusChannels(int busIdx)

Parameters

busIdx int

Returns

int

GetBusEffect(int, int)

Returns the AudioEffect at position effectIdx in bus busIdx.

public AudioEffect GetBusEffect(int busIdx, int effectIdx)

Parameters

busIdx int

effectIdx int

Returns

AudioEffect

GetBusEffectCount(int)

Returns the number of effects on the bus at busIdx.

public int GetBusEffectCount(int busIdx)

Parameters

busIdx int

Returns

int

GetBusEffectInstance(int, int, int)

Returns the AudioEffectInstance assigned to the given bus and effect indices (and optionally channel).

public AudioEffectInstance GetBusEffectInstance(int busIdx, int effectIdx, int channel = 0)

Parameters

busIdx int

effectIdx int

channel int

Returns

AudioEffectInstance

GetBusIndex(StringName)

Returns the index of the bus with the name busName. Returns -1 if no bus with the specified name exist.

public int GetBusIndex(StringName busName)

Parameters

busName StringName

Returns

int

GetBusName(int)

Returns the name of the bus with the index busIdx.

public string GetBusName(int busIdx)

Parameters

busIdx int

Returns

string

GetBusPeakVolumeLeftDb(int, int)

Returns the peak volume of the left speaker at bus index busIdx and channel index channel.

public float GetBusPeakVolumeLeftDb(int busIdx, int channel)

Parameters

busIdx int

channel int

Returns

float

GetBusPeakVolumeRightDb(int, int)

Returns the peak volume of the right speaker at bus index busIdx and channel index channel.

public float GetBusPeakVolumeRightDb(int busIdx, int channel)

Parameters

busIdx int

channel int

Returns

float

GetBusSend(int)

Returns the name of the bus that the bus at index busIdx sends to.

public StringName GetBusSend(int busIdx)

Parameters

busIdx int

Returns

StringName

GetBusVolumeDb(int)

Returns the volume of the bus at index busIdx in dB.

public float GetBusVolumeDb(int busIdx)

Parameters

busIdx int

Returns

float

GetInputDeviceList()

Returns the names of all audio input devices detected on the system.

Note: ProjectSettings.audio/driver/enable_input must be true for audio input to work. See also that setting's description for caveats related to permissions and operating system privacy settings.

public string[] GetInputDeviceList()

Returns

string[]

GetMixRate()

Returns the sample rate at the output of the AudioServer.

public float GetMixRate()

Returns

float

GetOutputDeviceList()

Returns the names of all audio output devices detected on the system.

public string[] GetOutputDeviceList()

Returns

string[]

GetOutputLatency()

Returns the audio driver's effective output latency. This is based on ProjectSettings.audio/driver/output_latency, but the exact returned value will differ depending on the operating system and audio driver.

Note: This can be expensive; it is not recommended to call GetOutputLatency() every frame.

public double GetOutputLatency()

Returns

double

GetSpeakerMode()

Returns the speaker configuration.

public AudioServer.SpeakerMode GetSpeakerMode()

Returns

AudioServer.SpeakerMode

GetTimeSinceLastMix()

Returns the relative time since the last mix occurred.

public double GetTimeSinceLastMix()

Returns

double

GetTimeToNextMix()

Returns the relative time until the next mix occurs.

public double GetTimeToNextMix()

Returns

double

HasGodotClassMethod(in godot_string_name)

Check if the type contains a method with the given name. This method is used by Godot to check if a method exists before invoking it. Do not call or override this method.

protected override bool HasGodotClassMethod(in godot_string_name method)

Parameters

method godot_string_name

Name of the method to check for.

Returns

bool

HasGodotClassSignal(in godot_string_name)

Check if the type contains a signal with the given name. This method is used by Godot to check if a signal exists before raising it. Do not call or override this method.

protected override bool HasGodotClassSignal(in godot_string_name signal)

Parameters

signal godot_string_name

Name of the signal to check for.

Returns

bool

InvokeGodotClassMethod(in godot_string_name, NativeVariantPtrArgs, out godot_variant)

Invokes the method with the given name, using the given arguments. This method is used by Godot to invoke methods from the engine side. Do not call or override this method.

protected override bool InvokeGodotClassMethod(in godot_string_name method, NativeVariantPtrArgs args, out godot_variant ret)

Parameters

method godot_string_name

Name of the method to invoke.

args NativeVariantPtrArgs

Arguments to use with the invoked method.

ret godot_variant

Value returned by the invoked method.

Returns

bool

IsBusBypassingEffects(int)

If true, the bus at index busIdx is bypassing effects.

public bool IsBusBypassingEffects(int busIdx)

Parameters

busIdx int

Returns

bool

IsBusEffectEnabled(int, int)

If true, the effect at index effectIdx on the bus at index busIdx is enabled.

public bool IsBusEffectEnabled(int busIdx, int effectIdx)

Parameters

busIdx int

effectIdx int

Returns

bool

IsBusMute(int)

If true, the bus at index busIdx is muted.

public bool IsBusMute(int busIdx)

Parameters

busIdx int

Returns

bool

IsBusSolo(int)

If true, the bus at index busIdx is in solo mode.

public bool IsBusSolo(int busIdx)

Parameters

busIdx int

Returns

bool

Lock()

Locks the audio driver's main loop.

Note: Remember to unlock it afterwards.

public void Lock()

MoveBus(int, int)

Moves the bus from index index to index toIndex.

public void MoveBus(int index, int toIndex)

Parameters

index int

toIndex int

RemoveBus(int)

Removes the bus at index index.

public void RemoveBus(int index)

Parameters

index int

RemoveBusEffect(int, int)

Removes the effect at index effectIdx from the bus at index busIdx.

public void RemoveBusEffect(int busIdx, int effectIdx)

Parameters

busIdx int

effectIdx int

SetBusBypassEffects(int, bool)

If true, the bus at index busIdx is bypassing effects.

public void SetBusBypassEffects(int busIdx, bool enable)

Parameters

busIdx int

enable bool

SetBusEffectEnabled(int, int, bool)

If true, the effect at index effectIdx on the bus at index busIdx is enabled.

public void SetBusEffectEnabled(int busIdx, int effectIdx, bool enabled)

Parameters

busIdx int

effectIdx int

enabled bool

SetBusLayout(AudioBusLayout)

Overwrites the currently used AudioBusLayout.

public void SetBusLayout(AudioBusLayout busLayout)

Parameters

busLayout AudioBusLayout

SetBusMute(int, bool)

If true, the bus at index busIdx is muted.

public void SetBusMute(int busIdx, bool enable)

Parameters

busIdx int

enable bool

SetBusName(int, string)

Sets the name of the bus at index busIdx to name.

public void SetBusName(int busIdx, string name)

Parameters

busIdx int

name string

SetBusSend(int, StringName)

Connects the output of the bus at busIdx to the bus named send.

public void SetBusSend(int busIdx, StringName send)

Parameters

busIdx int

send StringName

SetBusSolo(int, bool)

If true, the bus at index busIdx is in solo mode.

public void SetBusSolo(int busIdx, bool enable)

Parameters

busIdx int

enable bool

SetBusVolumeDb(int, float)

Sets the volume of the bus at index busIdx to volumeDb.

public void SetBusVolumeDb(int busIdx, float volumeDb)

Parameters

busIdx int

volumeDb float

SetEnableTaggingUsedAudioStreams(bool)

If set to true, all instances of AudioStreamPlayback will call _TagUsedStreams() every mix step.

Note: This is enabled by default in the editor, as it is used by editor plugins for the audio stream previews.

public void SetEnableTaggingUsedAudioStreams(bool enable)

Parameters

enable bool

SwapBusEffects(int, int, int)

Swaps the position of two effects in bus busIdx.

public void SwapBusEffects(int busIdx, int effectIdx, int byEffectIdx)

Parameters

busIdx int

effectIdx int

byEffectIdx int

Unlock()

Unlocks the audio driver's main loop. (After locking it, you should always unlock it.)

public void Unlock()

Events

BusLayoutChanged

Emitted when an audio bus is added, deleted, or moved.

public event Action BusLayoutChanged

Event Type

Action

BusRenamed

Emitted when the audio bus at busIndex is renamed from oldName to newName.

public event AudioServerInstance.BusRenamedEventHandler BusRenamed

Event Type

AudioServerInstance.BusRenamedEventHandler