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.

ResourceImporterWAV

繼承: ResourceImporter < RefCounted < Object

匯入 WAV 音訊檔案播放。

說明

WAV 是未經壓縮的格式,能夠提供比 Ogg Vorbis 和 MP3 更高的品質。解壓時的 CPU 開銷也最低。因此即便在低端裝置上,也能夠同時播放大量的 WAV 聲音。

預設情況下,Godot 使用有損的 Quite OK Audio 壓縮匯入 WAV 檔案。可以通過設定 compress/mode 屬性來更改。

教學

屬性

int

compress/mode

2

int

edit/loop_begin

0

int

edit/loop_end

-1

int

edit/loop_mode

0

bool

edit/normalize

false

bool

edit/trim

false

bool

force/8_bit

false

bool

force/max_rate

false

float

force/max_rate_hz

44100

bool

force/mono

false


屬性說明

int compress/mode = 2 🔗

匯入時使用的壓縮模式。

  • PCM (Uncompressed):匯入音訊資料,不進行壓縮,保持盡可能高的品質。CPU 開銷最低,但記憶體佔用最高。

  • IMA ADPCM:匯入時進行快速有損壓縮,顯著降低品質,但是 CPU 開銷和記憶體佔用都較低。不支援跳轉,僅支援 Forward 循環模式。

  • `Quite OK Audio <https://qoaformat.org/>`__:匯入時也會進行有損壓縮,CPU 開銷比 IMA ADPCM 略高,但是品質要高很多,記憶體佔用也最低。


int edit/loop_begin = 0 🔗

循環起始點,edit/loop_mode 為 Forward、Ping-Pong、或 Backward 時使用。設定的是音訊檔案開始之後的取樣數。


int edit/loop_end = -1 🔗

循環結束點,edit/loop_mode 為 Forward、Ping-Pong、或 Backward 時使用。設定的是音訊檔案開始之後的取樣數。-1 表示使用音訊檔案的末尾作為循環結束點。


int edit/loop_mode = 0 🔗

控制音訊如何循環。

  • 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 訊號,因為音訊會無限循環播放。


bool edit/normalize = false 🔗

如果true,則標準化音訊音量,使其峰值音量等於0 dB。啟用後,標準化將使音訊聽起來更響亮,取決於其原始峰值體積。


bool edit/trim = false 🔗

如果true,如果標準化後音訊低於-50 dB,則自動修剪音訊的開頭和結尾(請參閱edit/normalize)。這防止檔案在開頭或結尾處靜音,這不必要地增加了檔案的大小,並增加了播放時的延遲。在修剪過程中還使用了 500 個樣本的淡入/淡出週期,以避免聽到爆音。


bool force/8_bit = false 🔗

如果 true,如果來源檔案為 16 位元或更高,則強制匯入的音訊使用 8 位元量化。

通常不建議啟用此功能,因為 8 位元量化會顯著降低音訊品質。如果您需要較小的檔案大小,請考慮使用 Ogg Vorbis 或 MP3 音訊。


bool force/max_rate = false 🔗

如果設定為大於 0 的值,則強制音訊的取樣率降低到低於或等於 force/max_rate_hz 中指定的值。

這可以顯著減小某些聲音的檔案大小,而不會影響質量,具體取決於實際聲音的內容。有關詳細資訊,請參閱最佳實踐。


float force/max_rate_hz = 44100 🔗

代表粒子軌跡的時間量(以秒為單位)。僅當 force/max_rate 為 true 時有效。


bool force/mono = false 🔗

如果true,如果來源檔案是立體聲,則強制匯入的音訊為單聲道。透過將兩個通道合併為一個通道,可以將檔案大小減少50% 。