AudioStreamPlayer2D

Inherits: Node2D < CanvasItem < Node < Object

Plays positional sound in 2D space.

Description

Plays audio that dampens with distance from screen center.

See also AudioStreamPlayer to play a sound non-positionally.

Note: Hiding an AudioStreamPlayer2D node does not disable its audio output. To temporarily disable an AudioStreamPlayer2D's audio output, set volume_db to a very low value like -100 (which isn't audible to human hearing).

Tutorials

Methods

float

get_playback_position ( )

AudioStreamPlayback

get_stream_playback ( )

void

play ( float from_position=0.0 )

void

seek ( float to_position )

void

stop ( )

Signals

  • finished ( )

Emitted when the audio stops playing.

Property Descriptions

  • int area_mask

Default

1

Setter

set_area_mask(value)

Getter

get_area_mask()

Areas in which this sound plays.


Default

1.0

Setter

set_attenuation(value)

Getter

get_attenuation()

Dampens audio over distance with this as an exponent.


Default

false

Setter

set_autoplay(value)

Getter

is_autoplay_enabled()

If true, audio plays when added to scene tree.


Default

&"Master"

Setter

set_bus(value)

Getter

get_bus()

Bus on which this audio is playing.


Default

2000.0

Setter

set_max_distance(value)

Getter

get_max_distance()

Maximum distance from which audio is still hearable.


  • int max_polyphony

Default

1

Setter

set_max_polyphony(value)

Getter

get_max_polyphony()

The maximum number of sounds this node can play at the same time. Playing additional sounds after this value is reached will cut off the oldest sounds.


Default

1.0

Setter

set_pitch_scale(value)

Getter

get_pitch_scale()

The pitch and the tempo of the audio, as a multiplier of the audio sample's sample rate.


Default

false

Getter

is_playing()

If true, audio is playing.


Setter

set_stream(value)

Getter

get_stream()

The AudioStream object to be played.


  • bool stream_paused

Default

false

Setter

set_stream_paused(value)

Getter

get_stream_paused()

If true, the playback is paused. You can resume it by setting stream_paused to false.


Default

0.0

Setter

set_volume_db(value)

Getter

get_volume_db()

Base volume without dampening.

Method Descriptions

  • float get_playback_position ( )

Returns the position in the AudioStream.


Returns the AudioStreamPlayback object associated with this AudioStreamPlayer2D.


  • void play ( float from_position=0.0 )

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


  • void seek ( float to_position )

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


  • void stop ( )

Stops the audio.