AudioStreamPlayer

AudioStreamPlayer

Inherits: Node < Object

Plays back audio non-positionally.

Description

Plays an audio stream non-positionally.

To play audio positionally, use AudioStreamPlayer2D or AudioStreamPlayer3D instead of AudioStreamPlayer.

Tutorials

Properties

bool	autoplay	`false`
String	bus	`“Master”`
MixTarget	mix_target	`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 ( )
void	play ( float from_position=0.0 )
void	seek ( float to_position )
void	stop ( )

Signals

finished ( )

Emitted when the audio stops playing.

Enumerations

enum MixTarget:

MIX_TARGET_STEREO = 0 —- The audio will be played only on the first channel.
MIX_TARGET_SURROUND = 1 —- The audio will be played on all surround channels.
MIX_TARGET_CENTER = 2 —- The audio will be played on the second channel, which is usually the center.

Property Descriptions

bool autoplay

Default	`false`
Setter	set_autoplay(value)
Getter	is_autoplay_enabled()

If true, audio plays when added to scene tree.

String bus

Default	`“Master”`
Setter	set_bus(value)
Getter	get_bus()

Bus on which this audio is playing.

MixTarget mix_target

Default	`0`
Setter	set_mix_target(value)
Getter	get_mix_target()

If the audio configuration has more than two speakers, this sets the target channels. See MixTarget constants.

float pitch_scale

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.

bool playing

Default	`false`
Getter	is_playing()

If true, audio is playing.

AudioStream stream

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.

float volume_db

Default	`0.0`
Setter	set_volume_db(value)
Getter	get_volume_db()

Volume of sound, in dB.

Method Descriptions

float get_playback_position ( )

Returns the position in the AudioStream in seconds.

AudioStreamPlayback get_stream_playback ( )

Returns the AudioStreamPlayback object associated with this AudioStreamPlayer.

void play ( float from_position=0.0 )

Plays the audio from the given 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.