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

Eredita: AudioStream < Resource < RefCounted < Object

Driver di flusso audio MP3.

Descrizione

Driver per i flusso audio MP3. Vedi data se vuoi caricare un file MP3 in fase di esecuzione. Ulteriori informazioni sono disponibili in ResourceImporterMP3.

Nota: Questa classe può facoltativamente supportare i formati legacy MP1 e MP2, a condizione che il motore sia compilato con l'opzione minimp3_extra_formats=yes SCons. Questi formati in più non sono abilitati come predefinito.

Tutorial

Proprietà

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

Metodi

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

Descrizioni delle proprietà

int bar_beats = 4 🔗

void set_bar_beats(value: int)
int get_bar_beats()

Il numero di battiti all'interno di una singola battuta nella traccia audio.

int beat_count = 0 🔗

void set_beat_count(value: int)
int get_beat_count()

La durata della traccia audio, in battiti. La durata effettiva del file audio potrebbe essere più lunga di quanto indicato da questa proprietà. Definisce la fine dell'audio per la ripetizione, per AudioStreamPlaylist e per AudioStreamInteractive.

float bpm = 0.0 🔗

void set_bpm(value: float)
float get_bpm()

Il tempo della traccia audio, misurato in battiti al minuto.

PackedByteArray data = PackedByteArray() 🔗

void set_data(value: PackedByteArray)
PackedByteArray get_data()

Contiene i dati audio in byte.

È possibile caricare un file senza dover importarlo in anticipo usando lo snippet di codice qui sotto. Tieni conto che questo snippet carica l'intero file in memoria e potrebbe non essere ideale per i file enormi (centinaia di megabyte o più).

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()

Se true, il flusso verrà riprodotto di nuovo a partire dal loop_offset specificato una volta raggiunta la fine della traccia audio, oppure una volta raggiunta la fine dell'ultimo battito in base al numero specificato in beat_count. Utile per suoni ambientali e musica di sottofondo.

float loop_offset = 0.0 🔗

void set_loop_offset(value: float)
float get_loop_offset()

Tempo in secondi in cui il flusso comincia dopo essere stato ripetuto.

Descrizioni dei metodi

AudioStreamMP3 load_from_buffer(stream_data: PackedByteArray) static 🔗

Crea una nuova istanza di AudioStreamMP3 dal buffer indicato. Il buffer deve contenere i dati in MP3.

AudioStreamMP3 load_from_file(path: String) static 🔗

Crea una nuova istanza di AudioStreamMP3 dal percorso di file specificato. Il file deve essere in formato MP3.