Up to date

This page is up to date for Godot 4.3. If you still find outdated information, please open an issue.

AudioStreamMP3ΒΆ

Inherits: AudioStream < Resource < RefCounted < Object

MP3 audio stream driver.

DescriptionΒΆ

MP3 audio stream driver. See data if you want to load an MP3 file at run-time.

PropertiesΒΆ

int

bar_beats

4

int

beat_count

0

float

bpm

0.0

PackedByteArray

data

PackedByteArray()

bool

loop

false

float

loop_offset

0.0


Property DescriptionsΒΆ

int bar_beats = 4 πŸ”—

  • void set_bar_beats(value: int)

  • int get_bar_beats()

There is currently no description for this property. Please help us by contributing one!


int beat_count = 0 πŸ”—

  • void set_beat_count(value: int)

  • int get_beat_count()

There is currently no description for this property. Please help us by contributing one!


float bpm = 0.0 πŸ”—

There is currently no description for this property. Please help us by contributing one!


PackedByteArray data = PackedByteArray() πŸ”—

Contains the audio data in bytes.

You can load a file without having to import it beforehand using the code snippet below. Keep in mind that this snippet loads the whole file into memory and may not be ideal for huge files (hundreds of megabytes or more).

func load_mp3(path):
    var file = FileAccess.open(path, FileAccess.READ)
    var sound = AudioStreamMP3.new()
    sound.data = file.get_buffer(file.get_length())
    return sound

Note: The returned array is copied and any changes to it will not update the original property value. See PackedByteArray for more details.


bool loop = false πŸ”—

  • void set_loop(value: bool)

  • bool has_loop()

If true, the stream will automatically loop when it reaches the end.


float loop_offset = 0.0 πŸ”—

  • void set_loop_offset(value: float)

  • float get_loop_offset()

Time in seconds at which the stream starts after being looped.