godot-docs/classes/class_audioserver.rst

.. Generated automatically by doc/tools/makerst.py in Godot's source tree.
.. DO NOT EDIT THIS FILE, but the AudioServer.xml source instead.
.. The source is found in doc/classes or modules/<name>/doc_classes.

.. _class_AudioServer:

AudioServer
===========

**Inherits:** :ref:`Object<class_object>`

**Category:** Core

Brief Description
-----------------

Server interface for low level audio access.

Member Functions
----------------

+----------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| void                                         | :ref:`add_bus<class_AudioServer_add_bus>`  **(** :ref:`int<class_int>` at_position=-1  **)**                                                                                            |
+----------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| void                                         | :ref:`add_bus_effect<class_AudioServer_add_bus_effect>`  **(** :ref:`int<class_int>` bus_idx, :ref:`AudioEffect<class_audioeffect>` effect, :ref:`int<class_int>` at_position=-1  **)** |
+----------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`AudioBusLayout<class_audiobuslayout>`  | :ref:`generate_bus_layout<class_AudioServer_generate_bus_layout>`  **(** **)** const                                                                                                    |
+----------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`int<class_int>`                        | :ref:`get_bus_count<class_AudioServer_get_bus_count>`  **(** **)** const                                                                                                                |
+----------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`AudioEffect<class_audioeffect>`        | :ref:`get_bus_effect<class_AudioServer_get_bus_effect>`  **(** :ref:`int<class_int>` bus_idx, :ref:`int<class_int>` effect_idx  **)**                                                   |
+----------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`int<class_int>`                        | :ref:`get_bus_effect_count<class_AudioServer_get_bus_effect_count>`  **(** :ref:`int<class_int>` bus_idx  **)**                                                                         |
+----------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`int<class_int>`                        | :ref:`get_bus_index<class_AudioServer_get_bus_index>`  **(** :ref:`String<class_string>` bus_name  **)** const                                                                          |
+----------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`String<class_string>`                  | :ref:`get_bus_name<class_AudioServer_get_bus_name>`  **(** :ref:`int<class_int>` bus_idx  **)** const                                                                                   |
+----------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`float<class_float>`                    | :ref:`get_bus_peak_volume_left_db<class_AudioServer_get_bus_peak_volume_left_db>`  **(** :ref:`int<class_int>` bus_idx, :ref:`int<class_int>` channel  **)** const                      |
+----------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`float<class_float>`                    | :ref:`get_bus_peak_volume_right_db<class_AudioServer_get_bus_peak_volume_right_db>`  **(** :ref:`int<class_int>` bus_idx, :ref:`int<class_int>` channel  **)** const                    |
+----------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`String<class_string>`                  | :ref:`get_bus_send<class_AudioServer_get_bus_send>`  **(** :ref:`int<class_int>` bus_idx  **)** const                                                                                   |
+----------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`float<class_float>`                    | :ref:`get_bus_volume_db<class_AudioServer_get_bus_volume_db>`  **(** :ref:`int<class_int>` bus_idx  **)** const                                                                         |
+----------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`float<class_float>`                    | :ref:`get_mix_rate<class_AudioServer_get_mix_rate>`  **(** **)** const                                                                                                                  |
+----------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`int<class_int>`                        | :ref:`get_speaker_mode<class_AudioServer_get_speaker_mode>`  **(** **)** const                                                                                                          |
+----------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`bool<class_bool>`                      | :ref:`is_bus_bypassing_effects<class_AudioServer_is_bus_bypassing_effects>`  **(** :ref:`int<class_int>` bus_idx  **)** const                                                           |
+----------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`bool<class_bool>`                      | :ref:`is_bus_effect_enabled<class_AudioServer_is_bus_effect_enabled>`  **(** :ref:`int<class_int>` bus_idx, :ref:`int<class_int>` effect_idx  **)** const                               |
+----------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`bool<class_bool>`                      | :ref:`is_bus_mute<class_AudioServer_is_bus_mute>`  **(** :ref:`int<class_int>` bus_idx  **)** const                                                                                     |
+----------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`bool<class_bool>`                      | :ref:`is_bus_solo<class_AudioServer_is_bus_solo>`  **(** :ref:`int<class_int>` bus_idx  **)** const                                                                                     |
+----------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| void                                         | :ref:`lock<class_AudioServer_lock>`  **(** **)**                                                                                                                                        |
+----------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| void                                         | :ref:`move_bus<class_AudioServer_move_bus>`  **(** :ref:`int<class_int>` index, :ref:`int<class_int>` to_index  **)**                                                                   |
+----------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| void                                         | :ref:`remove_bus<class_AudioServer_remove_bus>`  **(** :ref:`int<class_int>` index  **)**                                                                                               |
+----------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| void                                         | :ref:`remove_bus_effect<class_AudioServer_remove_bus_effect>`  **(** :ref:`int<class_int>` bus_idx, :ref:`int<class_int>` effect_idx  **)**                                             |
+----------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| void                                         | :ref:`set_bus_bypass_effects<class_AudioServer_set_bus_bypass_effects>`  **(** :ref:`int<class_int>` bus_idx, :ref:`bool<class_bool>` enable  **)**                                     |
+----------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| void                                         | :ref:`set_bus_count<class_AudioServer_set_bus_count>`  **(** :ref:`int<class_int>` amount  **)**                                                                                        |
+----------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| void                                         | :ref:`set_bus_effect_enabled<class_AudioServer_set_bus_effect_enabled>`  **(** :ref:`int<class_int>` bus_idx, :ref:`int<class_int>` effect_idx, :ref:`bool<class_bool>` enabled  **)**  |
+----------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| void                                         | :ref:`set_bus_layout<class_AudioServer_set_bus_layout>`  **(** :ref:`AudioBusLayout<class_audiobuslayout>` bus_layout  **)**                                                            |
+----------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| void                                         | :ref:`set_bus_mute<class_AudioServer_set_bus_mute>`  **(** :ref:`int<class_int>` bus_idx, :ref:`bool<class_bool>` enable  **)**                                                         |
+----------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| void                                         | :ref:`set_bus_name<class_AudioServer_set_bus_name>`  **(** :ref:`int<class_int>` bus_idx, :ref:`String<class_string>` name  **)**                                                       |
+----------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| void                                         | :ref:`set_bus_send<class_AudioServer_set_bus_send>`  **(** :ref:`int<class_int>` bus_idx, :ref:`String<class_string>` send  **)**                                                       |
+----------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| void                                         | :ref:`set_bus_solo<class_AudioServer_set_bus_solo>`  **(** :ref:`int<class_int>` bus_idx, :ref:`bool<class_bool>` enable  **)**                                                         |
+----------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| void                                         | :ref:`set_bus_volume_db<class_AudioServer_set_bus_volume_db>`  **(** :ref:`int<class_int>` bus_idx, :ref:`float<class_float>` volume_db  **)**                                          |
+----------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| void                                         | :ref:`swap_bus_effects<class_AudioServer_swap_bus_effects>`  **(** :ref:`int<class_int>` bus_idx, :ref:`int<class_int>` effect_idx, :ref:`int<class_int>` by_effect_idx  **)**          |
+----------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| void                                         | :ref:`unlock<class_AudioServer_unlock>`  **(** **)**                                                                                                                                    |
+----------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+

Signals
-------

-  **bus_layout_changed**  **(** **)**

Numeric Constants
-----------------

- **SPEAKER_MODE_STEREO** = **0**
- **SPEAKER_SURROUND_51** = **2**
- **SPEAKER_SURROUND_71** = **3**

Description
-----------

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.

Member Function Description
---------------------------

.. _class_AudioServer_add_bus:

- void  **add_bus**  **(** :ref:`int<class_int>` at_position=-1  **)**

.. _class_AudioServer_add_bus_effect:

- void  **add_bus_effect**  **(** :ref:`int<class_int>` bus_idx, :ref:`AudioEffect<class_audioeffect>` effect, :ref:`int<class_int>` at_position=-1  **)**

.. _class_AudioServer_generate_bus_layout:

- :ref:`AudioBusLayout<class_audiobuslayout>`  **generate_bus_layout**  **(** **)** const

.. _class_AudioServer_get_bus_count:

- :ref:`int<class_int>`  **get_bus_count**  **(** **)** const

.. _class_AudioServer_get_bus_effect:

- :ref:`AudioEffect<class_audioeffect>`  **get_bus_effect**  **(** :ref:`int<class_int>` bus_idx, :ref:`int<class_int>` effect_idx  **)**

.. _class_AudioServer_get_bus_effect_count:

- :ref:`int<class_int>`  **get_bus_effect_count**  **(** :ref:`int<class_int>` bus_idx  **)**

.. _class_AudioServer_get_bus_index:

- :ref:`int<class_int>`  **get_bus_index**  **(** :ref:`String<class_string>` bus_name  **)** const

.. _class_AudioServer_get_bus_name:

- :ref:`String<class_string>`  **get_bus_name**  **(** :ref:`int<class_int>` bus_idx  **)** const

.. _class_AudioServer_get_bus_peak_volume_left_db:

- :ref:`float<class_float>`  **get_bus_peak_volume_left_db**  **(** :ref:`int<class_int>` bus_idx, :ref:`int<class_int>` channel  **)** const

.. _class_AudioServer_get_bus_peak_volume_right_db:

- :ref:`float<class_float>`  **get_bus_peak_volume_right_db**  **(** :ref:`int<class_int>` bus_idx, :ref:`int<class_int>` channel  **)** const

.. _class_AudioServer_get_bus_send:

- :ref:`String<class_string>`  **get_bus_send**  **(** :ref:`int<class_int>` bus_idx  **)** const

.. _class_AudioServer_get_bus_volume_db:

- :ref:`float<class_float>`  **get_bus_volume_db**  **(** :ref:`int<class_int>` bus_idx  **)** const

.. _class_AudioServer_get_mix_rate:

- :ref:`float<class_float>`  **get_mix_rate**  **(** **)** const

.. _class_AudioServer_get_speaker_mode:

- :ref:`int<class_int>`  **get_speaker_mode**  **(** **)** const

.. _class_AudioServer_is_bus_bypassing_effects:

- :ref:`bool<class_bool>`  **is_bus_bypassing_effects**  **(** :ref:`int<class_int>` bus_idx  **)** const

.. _class_AudioServer_is_bus_effect_enabled:

- :ref:`bool<class_bool>`  **is_bus_effect_enabled**  **(** :ref:`int<class_int>` bus_idx, :ref:`int<class_int>` effect_idx  **)** const

.. _class_AudioServer_is_bus_mute:

- :ref:`bool<class_bool>`  **is_bus_mute**  **(** :ref:`int<class_int>` bus_idx  **)** const

.. _class_AudioServer_is_bus_solo:

- :ref:`bool<class_bool>`  **is_bus_solo**  **(** :ref:`int<class_int>` bus_idx  **)** const

.. _class_AudioServer_lock:

- void  **lock**  **(** **)**

.. _class_AudioServer_move_bus:

- void  **move_bus**  **(** :ref:`int<class_int>` index, :ref:`int<class_int>` to_index  **)**

.. _class_AudioServer_remove_bus:

- void  **remove_bus**  **(** :ref:`int<class_int>` index  **)**

.. _class_AudioServer_remove_bus_effect:

- void  **remove_bus_effect**  **(** :ref:`int<class_int>` bus_idx, :ref:`int<class_int>` effect_idx  **)**

.. _class_AudioServer_set_bus_bypass_effects:

- void  **set_bus_bypass_effects**  **(** :ref:`int<class_int>` bus_idx, :ref:`bool<class_bool>` enable  **)**

.. _class_AudioServer_set_bus_count:

- void  **set_bus_count**  **(** :ref:`int<class_int>` amount  **)**

.. _class_AudioServer_set_bus_effect_enabled:

- void  **set_bus_effect_enabled**  **(** :ref:`int<class_int>` bus_idx, :ref:`int<class_int>` effect_idx, :ref:`bool<class_bool>` enabled  **)**

.. _class_AudioServer_set_bus_layout:

- void  **set_bus_layout**  **(** :ref:`AudioBusLayout<class_audiobuslayout>` bus_layout  **)**

.. _class_AudioServer_set_bus_mute:

- void  **set_bus_mute**  **(** :ref:`int<class_int>` bus_idx, :ref:`bool<class_bool>` enable  **)**

.. _class_AudioServer_set_bus_name:

- void  **set_bus_name**  **(** :ref:`int<class_int>` bus_idx, :ref:`String<class_string>` name  **)**

.. _class_AudioServer_set_bus_send:

- void  **set_bus_send**  **(** :ref:`int<class_int>` bus_idx, :ref:`String<class_string>` send  **)**

.. _class_AudioServer_set_bus_solo:

- void  **set_bus_solo**  **(** :ref:`int<class_int>` bus_idx, :ref:`bool<class_bool>` enable  **)**

.. _class_AudioServer_set_bus_volume_db:

- void  **set_bus_volume_db**  **(** :ref:`int<class_int>` bus_idx, :ref:`float<class_float>` volume_db  **)**

.. _class_AudioServer_swap_bus_effects:

- void  **swap_bus_effects**  **(** :ref:`int<class_int>` bus_idx, :ref:`int<class_int>` effect_idx, :ref:`int<class_int>` by_effect_idx  **)**

.. _class_AudioServer_unlock:

- void  **unlock**  **(** **)**