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 声音。
教程¶
属性¶
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
属性说明¶
导入时使用的压缩模式。
Disabled：导入音频数据，不进行压缩。得到的质量最高。
RAM (Ima-ADPCM)：导入时进行快速有损压缩。CPU 开销较低，但质量比 Ogg Vorbis 甚至是 MP3 都显著更低。
QOA (`Quite OK Audio <https://qoaformat.org/>`__)：导入时进行有损压缩。CPU 开销比 IMA-ADPCM 略高，但是质量要高很多。
The begin loop point to use when edit/loop_mode is Forward, Ping-Pong, or Backward. This is set in samples after the beginning of the audio file.
The end loop point to use when edit/loop_mode is Forward, Ping-Pong, or Backward. This is set in samples after the beginning of the audio file. A value of -1 uses the end of the audio file as the end loop point.
控制音频如何循环。导入时会自动从 WAV 元数据读取。
Disabled：不循环，即便元数据显示该文件应该在播放时循环。
Forward：标准音频循环。
Ping-Pong：正向播放音频，播放完以后再反向播放，再不断重复。原理类似于纹理的镜像重复。
Backward：逆向播放音频，播放完以后再从末尾开始循环播放。
注意：在 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%。