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...
ResourceImporterWAV
Eredita: ResourceImporter < RefCounted < Object
Importa un file audio WAV per la riproduzione.
Descrizione
WAV è un formato non compresso, il che può fornire una qualità superiore rispetto a Ogg Vorbis e MP3. Ha anche il costo di CPU più basso per la decodifica. Ciò significa che è possibile riprodurre un numero elevato di suoni WAV allo stesso tempo, anche su dispositivi di fascia bassa.
Come predefinito, Godot importa i file WAV usando la compressione lossy Quite OK Audio. È possibile cambiare questa impostazione modificando la proprietà compress/mode.
Tutorial
Proprietà
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
Descrizioni delle proprietà
La modalità di compressione da utilizzare durante l'importazione.
PCM (Uncompressed): Importa i dati audio senza alcuna forma di compressione, preservando la massima qualità possibile. Ha il costo di CPU più basso, ma il più alto utilizzo di memoria.
IMA ADPCM: Applica una compressione veloce e con perdita di dati durante l'importazione, riducendo notevolmente la qualità, ma con un basso costo di CPU e un basso utilizzo di memoria. Non supporta la ricerca e supporta solo la modalità di loop Forward.
`Quite OK Audio <https://qoaformat.org/>`__: Applica anche una compressione con perdita di dati durante l'importazione, con un costo di CPU leggermente più alto rispetto a IMA ADPCM, ma una qualità molto più alta e il più basso utilizzo di memoria.
Il punto di inizio del loop da utilizzare quando edit/loop_mode è Forward, Ping-Pong o Backward. Questo è impostato nei campioni dopo l'inizio del file audio.
Il punto di fine del loop da utilizzare quando edit/loop_mode è Forward, Ping-Pong o Backward. Questo è impostato nei campioni dopo l'inizio del file audio. Un valore di -1 usa la fine del file audio come punto di fine del loop.
Controlla come l'audio dovrebbe essere riprodotto in loop.
Detect from WAV: Utilizza le informazioni sul loop dai metadati WAV.
Disabled: Non riprodurre l'audio in loop, anche se i metadati indicano che la riproduzione del file dovrebbe avere un loop.
Forward: Loop standard dell'audio. Riproduce l'audio in avanti dall'inizio a edit/loop_end, quindi torna a edit/loop_begin e ripete.
Ping-Pong: Riproduce l'audio in avanti fino a edit/loop_end, poi all'indietro fino a edit/loop_begin, poi ripete il ciclo.
Back: Riproduce l'audio all'indietro da edit/loop_end a edit/loop_begin, quindi ripete.
Nota: In AudioStreamPlayer, il segnale AudioStreamPlayer.finished non verrà emesso per l'audio in ripetizione quando raggiunge la fine del file audio, poiché l'audio continuerà a essere riprodotto indefinitamente.
Se true, normalizza il volume audio in modo che il suo volume di picco sia uguale a 0 dB. Quando abilitata, la normalizzazione renderà il suono audio più forte a seconda del suo volume di picco originale.
Se true, ritaglia automaticamente l'inizio e la fine dell'audio se è inferiore a -50 dB dopo la normalizzazione (vedi edit/normalize). Questo impedisce di avere file con silenzio all'inizio o alla fine, il che ne aumenta inutilmente le dimensioni e aggiunge latenza al momento in cui vengono riprodotti. Un periodo di dissolvenza in entrata/uscita di 500 campioni viene utilizzato anche durante il taglio per evitare schiocchi udibili.
Se true, forza l'audio importato a usare la quantizzazione a 8 bit se il file sorgente è a 16 bit o superiore.
In genere, non è consigliabile abilitare questa opzione, poiché la quantizzazione a 8 bit riduce notevolmente la qualità dell'audio. Se hai bisogno di file di dimensioni inferiori, considera di usare invece audio Ogg Vorbis o MP3.
Se impostato su un valore maggiore di 0, forza la riduzione della frequenza di campionamento dell'audio a un valore inferiore o uguale al valore specificato in force/max_rate_hz.
Questo può ridurre notevolmente le dimensioni del file su determinati suoni, senza influire sulla qualità a seconda del contenuto effettivo del suono. Consulta Best practice per maggiori informazioni.
float force/max_rate_hz = 44100 🔗
La frequenza a cui limitare il campione audio importato (in Hz). Efficace solo se force/max_rate è true.
Se true, forza l'audio importato a essere mono se il file sorgente è stereo. Ciò riduce la dimensione del file del 50% unendo i due canali in uno.