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.

ResourceImporterMP3

Eredita: ResourceImporter < RefCounted < Object

Importa un file audio MP3 per la riproduzione.

Descrizione

MP3 è un formato audio lossy (con perdita), con una qualità audio peggiore rispetto a ResourceImporterOggVorbis a un determinato bitrate.

Nella maggior parte dei casi, si consiglia di utilizzare Ogg Vorbis apposto di MP3. Tuttavia, se si utilizza una sorgente audio MP3 senza una sorgente di qualità superiore disponibile, si consiglia di utilizzare direttamente il file MP3 per evitare una doppia compressione lossy.

MP3 richiede più tempo sulla CPU per la decodifica rispetto a ResourceImporterWAV. Se è necessario riprodurre molti suoni allo stesso tempo, si consiglia di utilizzare WAV per quei suoni, soprattutto se destinati a dispositivi di fascia bassa.

Tutorial

Proprietà

int

bar_beats

4

int

beat_count

0

float

bpm

0

bool

loop

false

float

loop_offset

0


Descrizioni delle proprietà

int bar_beats = 4 🔗

Il numero di battute in un singolo battito nella traccia audio. Rilevante solo per la musica che intende utilizzare la funzionalità di musica interattiva, non per gli effetti sonori.

Nella finestra di dialogo Impostazioni d'importazione avanzate è fornito un editor più comodo per bar_beats, in quanto consente di visualizzare le modifiche in anteprima senza dover reimportare l'audio.


int beat_count = 0 🔗

La durata della traccia audio, in battiti. La durata effettiva del file audio potrebbe essere più grande di quella indicata da questa proprietà. Rilevante solo per la musica che intende utilizzare la funzionalità di musica interattiva, non per gli effetti sonori.

Nella finestra di dialogo Impostazioni d'importazione avanzate è fornito un editor più comodo per beat_count, in quanto consente di visualizzare le modifiche in anteprima senza dover reimportare l'audio.


float bpm = 0 🔗

Il tempo della traccia audio, misurato in battiti al minuto. Dovrebbe corrispondere alla misura del BPM che è stata usata per comporre la traccia. Rilevante solo per la musica che intende utilizzare la funzionalità di musica interattiva, non per gli effetti sonori.

Nella finestra di dialogo Impostazioni d'importazione avanzate è fornito un editor più comodo per bpm, in quanto consente di visualizzare le modifiche in anteprima senza dover reimportare l'audio.


bool loop = false 🔗

Se abilitato, l'audio verrà riprodotto dall'inizio o da loop_offset, dopo aver terminato la sua riproduzione raggiungendo la fine dell'audio o dell'ultimo battito, a seconda del numero specificato in beat_count.

Nota: In AudioStreamPlayer, il segnale AudioStreamPlayer.finished non sarà emesso per l'audio in ripetizione quando raggiunge la fine del file audio, poiché l'audio continuerà a essere riprodotto indefinitamente.


float loop_offset = 0 🔗

Determina dove l'audio inizierà a ripetersi dopo che la riproduzione ha raggiunto la fine dell'audio. Può essere utilizzato per ripetere solo una parte del file audio, il che è utile per alcuni suoni ambientali o musica. Il valore è determinato in secondi dall'inizio dell'audio. Un valore di 0.0 ripeterà l'intero file audio.

Ha effetto solo se loop è true.

Nella finestra di dialogo Impostazioni d'importazione avanzate è fornito un editor più comodo per loop_offset, in quanto consente di visualizzare le modifiche in anteprima senza dover reimportare l'audio.