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...
AudioStreamPlaybackPolyphonic¶
Inherits: AudioStreamPlayback < RefCounted < Object
Playback instance for AudioStreamPolyphonic.
Description¶
Playback instance for AudioStreamPolyphonic. After setting the stream property of AudioStreamPlayer, AudioStreamPlayer2D, or AudioStreamPlayer3D, the playback instance can be obtained by calling AudioStreamPlayer.get_stream_playback, AudioStreamPlayer2D.get_stream_playback or AudioStreamPlayer3D.get_stream_playback methods.
Methods¶
is_stream_playing(stream: int) const |
|
play_stream(stream: AudioStream, from_offset: float = 0, volume_db: float = 0, pitch_scale: float = 1.0) |
|
void |
set_stream_pitch_scale(stream: int, pitch_scale: float) |
void |
set_stream_volume(stream: int, volume_db: float) |
void |
stop_stream(stream: int) |
Constants¶
INVALID_ID = -1
Returned by play_stream in case it could not allocate a stream for playback.
Method Descriptions¶
bool is_stream_playing(stream: int) const
Return true whether the stream associated with an integer ID is still playing. Check play_stream for information on when this ID becomes invalid.
int play_stream(stream: AudioStream, from_offset: float = 0, volume_db: float = 0, pitch_scale: float = 1.0)
Play an AudioStream at a given offset, volume and pitch scale. Playback starts immediately.
The return value is a unique integer ID that is associated to this playback stream and which can be used to control it.
This ID becomes invalid when the stream ends (if it does not loop), when the AudioStreamPlaybackPolyphonic is stopped, or when stop_stream is called.
This function returns INVALID_ID if the amount of streams currently playing equals AudioStreamPolyphonic.polyphony. If you need a higher amount of maximum polyphony, raise this value.
void set_stream_pitch_scale(stream: int, pitch_scale: float)
Change the stream pitch scale. The stream argument is an integer ID returned by play_stream.
void set_stream_volume(stream: int, volume_db: float)
Change the stream volume (in db). The stream argument is an integer ID returned by play_stream.
void stop_stream(stream: int)
Stop a stream. The stream argument is an integer ID returned by play_stream, which becomes invalid after calling this function.