Attention: Here be dragons

This is the latest (unstable) version of this documentation, which may document features not available in or compatible with released stable versions of Godot.

Checking the stable version of the documentation...

AudioStreamPlayer2D¶

Inherits: Node2D < CanvasItem < Node < Object

Plays positional sound in 2D space.

Description¶

Plays audio that is attenuated with distance to the listener.

By default, audio is heard from the screen center. This can be changed by adding an AudioListener2D node to the scene and enabling it by calling AudioListener2D.make_current on it.

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¶

Audio streams

Properties¶

int	area_mask	`1`
float	attenuation	`1.0`
bool	autoplay	`false`
StringName	bus	`&"Master"`
float	max_distance	`2000.0`
int	max_polyphony	`1`
float	panning_strength	`1.0`
float	pitch_scale	`1.0`
bool	playing	`false`
AudioStream	stream
bool	stream_paused	`false`
float	volume_db	`0.0`

Methods¶

float	get_playback_position ( )
AudioStreamPlayback	get_stream_playback ( )
bool	has_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 = 1

void set_area_mask ( int value )
int get_area_mask ( )

Determines which Area2D layers affect the sound for reverb and audio bus effects. Areas can be used to redirect