ResourceImporterOggVorbis

Eredita: ResourceImporter < RefCounted < Object

Importa un file audio Ogg Vorbis per la riproduzione.

Descrizione

Ogg Vorbis è un formato audio lossy (con perdita), con una migliore qualità audio rispetto a ResourceImporterMP3 a un determinato bitrate.

Nella maggior parte dei casi, si consiglia di utilizzare Ogg Vorbis al posto 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.

Ogg Vorbis richiede più 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

Metodi

AudioStreamOggVorbis

load_from_buffer(stream_data: PackedByteArray) static

AudioStreamOggVorbis

load_from_file(path: String) static


Descrizioni delle proprietà

int bar_beats = 4 🔗

Il numero di battute in un singolo battito nella traccia audio. Rilevante solo per la musica con funzionalità interattiva, non 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 🔗

Il numero di battiti nella traccia audio. Rilevante solo per la musica con funzionalità interattiva, non 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 🔗

I battiti al minuto della traccia audio. Dovrebbe corrispondere alla misura del BPM che è stata usata per comporre la traccia. Rilevante solo per la musica con funzionalità interattiva, non 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 sarà riprodotto dall'inizio dopo che la riproduzione termina raggiungendo la fine dell'audio.

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.


Descrizioni dei metodi

AudioStreamOggVorbis load_from_buffer(stream_data: PackedByteArray) static 🔗

Deprecato: Use AudioStreamOggVorbis.load_from_buffer() instead.

Crea una nuova istanza AudioStreamOggVorbis dal buffer fornito. Il buffer deve contenere i dati in Ogg Vorbis.


AudioStreamOggVorbis load_from_file(path: String) static 🔗

Deprecato: Use AudioStreamOggVorbis.load_from_file() instead.

Crea una nuova istanza AudioStreamOggVorbis dal percorso di file fornito. Il file deve essere in formato Ogg Vorbis.