godot-docs/classes/class_audiostreamplayer3d.rst

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

.. _class_AudioStreamPlayer3D:

AudioStreamPlayer3D
===================

**Inherits:** :ref:`Spatial<class_spatial>` **<** :ref:`Node<class_node>` **<** :ref:`Object<class_object>`

**Category:** Core

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

Plays 3D sound in 3D space.

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

+----------------------------+-----------------------------------------------------------------------------------------------------+
| :ref:`float<class_float>`  | :ref:`get_playback_position<class_AudioStreamPlayer3D_get_playback_position>` **(** **)**           |
+----------------------------+-----------------------------------------------------------------------------------------------------+
| void                       | :ref:`play<class_AudioStreamPlayer3D_play>` **(** :ref:`float<class_float>` from_position=0.0 **)** |
+----------------------------+-----------------------------------------------------------------------------------------------------+
| void                       | :ref:`seek<class_AudioStreamPlayer3D_seek>` **(** :ref:`float<class_float>` to_position **)**       |
+----------------------------+-----------------------------------------------------------------------------------------------------+
| void                       | :ref:`stop<class_AudioStreamPlayer3D_stop>` **(** **)**                                             |
+----------------------------+-----------------------------------------------------------------------------------------------------+

Signals
-------

.. _class_AudioStreamPlayer3D_finished:

- **finished** **(** **)**

Fires when the audio stops playing.


Member Variables
----------------

  .. _class_AudioStreamPlayer3D_area_mask:

- :ref:`int<class_int>` **area_mask** - Areas in which this sound plays.

  .. _class_AudioStreamPlayer3D_attenuation_filter_cutoff_hz:

- :ref:`float<class_float>` **attenuation_filter_cutoff_hz** - Dampens audio above this frequency, in Hz.

  .. _class_AudioStreamPlayer3D_attenuation_filter_db:

- :ref:`float<class_float>` **attenuation_filter_db** - Amount how much the filter affects the loudness, in dB.

  .. _class_AudioStreamPlayer3D_attenuation_model:

- :ref:`AttenuationModel<enum_audiostreamplayer3d_attenuationmodel>` **attenuation_model** - Decides if audio should get quieter with distance linearly, quadratically or logarithmically.

  .. _class_AudioStreamPlayer3D_autoplay:

- :ref:`bool<class_bool>` **autoplay** - If ``true`` audio plays when added to scene tree. Default value: ``false``.

  .. _class_AudioStreamPlayer3D_bus:

- :ref:`String<class_string>` **bus** - Bus on which this audio is playing.

  .. _class_AudioStreamPlayer3D_doppler_tracking:

- :ref:`DopplerTracking<enum_audiostreamplayer3d_dopplertracking>` **doppler_tracking** - Decides in which step the Doppler effect should be calculated.

  .. _class_AudioStreamPlayer3D_emission_angle_degrees:

- :ref:`float<class_float>` **emission_angle_degrees** - The angle in which the audio reaches cameras undampened.

  .. _class_AudioStreamPlayer3D_emission_angle_enabled:

- :ref:`bool<class_bool>` **emission_angle_enabled** - If ``true`` the audio should be dampened according to the direction of the sound.

  .. _class_AudioStreamPlayer3D_emission_angle_filter_attenuation_db:

- :ref:`float<class_float>` **emission_angle_filter_attenuation_db** - dampens audio if camera is outside of 'emission_angle_degrees' and 'emission_angle_enabled' is set by this factor, in dB.

  .. _class_AudioStreamPlayer3D_max_db:

- :ref:`float<class_float>` **max_db** - Sets the absolute maximum of the soundlevel, in dB.

  .. _class_AudioStreamPlayer3D_max_distance:

- :ref:`float<class_float>` **max_distance** - Sets the distance from which the 'out_of_range_mode' takes effect. Has no effect if set to 0.

  .. _class_AudioStreamPlayer3D_out_of_range_mode:

- :ref:`OutOfRangeMode<enum_audiostreamplayer3d_outofrangemode>` **out_of_range_mode** - Decides if audio should pause when source is outside of 'max_distance' range.

  .. _class_AudioStreamPlayer3D_playing:

- :ref:`bool<class_bool>` **playing** - If ``true``, audio is playing.

  .. _class_AudioStreamPlayer3D_stream:

- :ref:`AudioStream<class_audiostream>` **stream** - The :ref:`AudioStream<class_audiostream>` object to be played.

  .. _class_AudioStreamPlayer3D_unit_db:

- :ref:`float<class_float>` **unit_db** - Base sound level unaffected by dampening, in dB.

  .. _class_AudioStreamPlayer3D_unit_size:

- :ref:`float<class_float>` **unit_size** - Factor for the attenuation effect.


Enums
-----

  .. _enum_AudioStreamPlayer3D_DopplerTracking:

enum **DopplerTracking**

- **DOPPLER_TRACKING_DISABLED** = **0** --- Disables doppler tracking.
- **DOPPLER_TRACKING_IDLE_STEP** = **1** --- Executes doppler tracking in idle step.
- **DOPPLER_TRACKING_PHYSICS_STEP** = **2** --- Executes doppler tracking in physics step.

  .. _enum_AudioStreamPlayer3D_OutOfRangeMode:

enum **OutOfRangeMode**

- **OUT_OF_RANGE_MIX** = **0** --- Mix this audio in, even when it's out of range.
- **OUT_OF_RANGE_PAUSE** = **1** --- Pause this audio when it gets out of range.

  .. _enum_AudioStreamPlayer3D_AttenuationModel:

enum **AttenuationModel**

- **ATTENUATION_INVERSE_DISTANCE** = **0** --- Linear dampening of loudness according to distance.
- **ATTENUATION_INVERSE_SQUARE_DISTANCE** = **1** --- Squared dampening of loudness according to distance.
- **ATTENUATION_LOGARITHMIC** = **2** --- Logarithmic dampening of loudness according to distance.


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

Plays a sound effect with directed sound effects, dampens with distance if needed, generates effect of hearable position in space.

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

.. _class_AudioStreamPlayer3D_get_playback_position:

- :ref:`float<class_float>` **get_playback_position** **(** **)**

Returns the position in the :ref:`AudioStream<class_audiostream>`.

.. _class_AudioStreamPlayer3D_play:

- void **play** **(** :ref:`float<class_float>` from_position=0.0 **)**

Plays the audio from the given position 'from_position', in seconds.

.. _class_AudioStreamPlayer3D_seek:

- void **seek** **(** :ref:`float<class_float>` to_position **)**

Sets the position from which audio will be played, in seconds.

.. _class_AudioStreamPlayer3D_stop:

- void **stop** **(** **)**

Stops the audio.