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
繼承: ResourceImporter < RefCounted < Object
匯入 WAV 音訊檔案播放。
說明
WAV 是未經壓縮的格式,能夠提供比 Ogg Vorbis 和 MP3 更高的品質。解壓時的 CPU 開銷也最低。因此即便在低端裝置上,也能夠同時播放大量的 WAV 聲音。
預設情況下,Godot 使用有損的 Quite OK Audio 壓縮匯入 WAV 檔案。可以通過設定 compress/mode 屬性來更改。
教學
屬性
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
屬性說明
匯入時使用的壓縮模式。
PCM (Uncompressed):匯入音訊資料,不進行壓縮,保持盡可能高的品質。CPU 開銷最低,但記憶體佔用最高。
IMA ADPCM:匯入時進行快速有損壓縮,顯著降低品質,但是 CPU 開銷和記憶體佔用都較低。不支援跳轉,僅支援 Forward 循環模式。
`Quite OK Audio <https://qoaformat.org/>`__:匯入時也會進行有損壓縮,CPU 開銷比 IMA ADPCM 略高,但是品質要高很多,記憶體佔用也最低。
循環起始點,edit/loop_mode 為 Forward、Ping-Pong、或 Backward 時使用。設定的是音訊檔案開始之後的取樣數。
循環結束點,edit/loop_mode 為 Forward、Ping-Pong、或 Backward 時使用。設定的是音訊檔案開始之後的取樣數。-1 表示使用音訊檔案的末尾作為循環結束點。
控制音訊如何循環。
Detect From WAV:使用 WAV 中繼資料中的循環資訊。
Disabled:不循環音訊,即便中繼資料顯示該檔案應該在播放時循環。
Forward:標準音訊循環。從頭開始正向播放音訊至 edit/loop_end,然後回到 edit/loop_begin 再進行重複。
Ping-Pong:正向播放音訊至 edit/loop_end,然後逆向播放至 edit/loop_begin,再重複這一循環。
Backward:從 edit/loop_end 至 edit/loop_begin 逆向播放音訊,再進行重複。
注意:在 AudioStreamPlayer 中,循環音訊到達音訊檔案末尾時不會發出 AudioStreamPlayer.finished 訊號,因為音訊會無限循環播放。
如果true,則標準化音訊音量,使其峰值音量等於0 dB。啟用後,標準化將使音訊聽起來更響亮,取決於其原始峰值體積。
如果true,如果標準化後音訊低於-50 dB,則自動修剪音訊的開頭和結尾(請參閱edit/normalize)。這防止檔案在開頭或結尾處靜音,這不必要地增加了檔案的大小,並增加了播放時的延遲。在修剪過程中還使用了 500 個樣本的淡入/淡出週期,以避免聽到爆音。
如果 true,如果來源檔案為 16 位元或更高,則強制匯入的音訊使用 8 位元量化。
通常不建議啟用此功能,因為 8 位元量化會顯著降低音訊品質。如果您需要較小的檔案大小,請考慮使用 Ogg Vorbis 或 MP3 音訊。
如果設定為大於 0 的值,則強制音訊的取樣率降低到低於或等於 force/max_rate_hz 中指定的值。
這可以顯著減小某些聲音的檔案大小,而不會影響質量,具體取決於實際聲音的內容。有關詳細資訊,請參閱最佳實踐。
float force/max_rate_hz = 44100 🔗
代表粒子軌跡的時間量(以秒為單位)。僅當 force/max_rate 為 true 時有效。
如果true,如果來源檔案是立體聲,則強制匯入的音訊為單聲道。透過將兩個通道合併為一個通道,可以將檔案大小減少50% 。