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...

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.

Note: This class can optionally support legacy MP1 and MP2 formats, provided that the engine is compiled with the minimp3_extra_formats=yes SCons option. These extra formats are not enabled by default.

Properties

int	bar_beats	`4`
int	beat_count	`0`
float	bpm	`0.0`
PackedByteArray	data	`PackedByteArray()`
bool	loop	`false`
float	loop_offset	`0.0`

Methods

AudioStreamMP3	load_from_buffer(stream_data: PackedByteArray) static
AudioStreamMP3	load_from_file(path: String) static

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 🔗

void set_bpm(value: float)
float get_bpm()

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

PackedByteArray data = PackedByteArray() 🔗

void set_data(value: PackedByteArray)
PackedByteArray get_data()

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

public AudioStreamMP3 LoadMP3(string path)
{
    using var file = FileAccess.Open(path, FileAccess.ModeFlags.Read);
    var sound = new AudioStreamMP3();
    sound.Data = file.GetBuffer(file.GetLength());
    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.

Method Descriptions

AudioStreamMP3 load_from_buffer(stream_data: PackedByteArray) static 🔗

Creates a new AudioStreamMP3 instance from the given buffer. The buffer must contain MP3 data.

AudioStreamMP3 load_from_file(path: String) static 🔗

Creates a new AudioStreamMP3 instance from the given file path. The file must be in MP3 format.