导入音频采样

支持的音频格式

Godot provides 3 options to import your audio data: WAV, Ogg Vorbis and MP3.

不同的格式各有优点：

• WAV 文件使用原始数据或轻度压缩（IMA-ADPCM）。播放这种格式的 CPU 开销很小（同时播放上千个都没问题）。缺点是会占用大量的磁盘空间。

• Ogg Vorbis 文件使用更强的压缩，因此文件更小，但需要更多的处理能力才能播放。

• MP3 files use better compression than WAV with IMA-ADPCM, but worse than Ogg Vorbis. This means that a MP3 file with roughly equal quality to Ogg Vorbis will be significantly larger. On the bright side, MP3 requires less CPU usage to play back compared to Ogg Vorbis.

备注

如果你从源代码编译 Godot 编辑器时禁用了特定的模块，某些格式可能无法使用。

Here is a comparative chart representing the file size of 1 second of audio with each format:

Note that the MP3 and Ogg Vorbis figures can vary depending on the encoding type. The above figures use CBR encoding for simplicity, but most Ogg Vorbis and MP3 files you can find online are encoded with VBR encoding which is more efficient. VBR encoding makes the effective audio file size depend on how “complex” the source audio is.

小技巧

Consider using WAV for short and repetitive sound effects, and Ogg Vorbis for music, speech, and long sound effects. MP3 is useful for mobile and web projects where CPU resources are limited, especially when playing multiple compressed sounds at the same time (such as long ambient sounds).

导入音频采样

Several options are available in the Import dock after selecting a WAV file in the FileSystem dock:

Import options in the Import dock after selecting a WAV file in the FileSystem dock

The set of options available after selecting a Ogg Vorbis or MP3 file is different:

Import options in the Import dock after selecting a MP3 file in the FileSystem dock. Options are identical for Ogg Vorbis files.

After importing a sound, you can play it back using the AudioStreamPlayer, AudioStreamPlayer2D or AudioStreamPlayer3D nodes. See 音频流 for more information.

导入选项（WAV）

Force > 8 Bit

If enabled, forces the imported audio to use 8-bit quantization if the source file is 16-bit or higher.

Enabling this is generally not recommended, as 8-bit quantization decreases audio quality significantly. If you need smaller file sizes, consider using Ogg Vorbis or MP3 audio instead.

Force > Mono

If enabled, forces the imported audio to be mono if the source file is stereo. This decreases the file size by 50% by merging the two channels into one.

Force > Max Rate

If set to a value greater than 0, forces the audio’s sample rate to be reduced to a value lower than or equal to the value specified here.

This can decrease file size noticeably on certain sounds, without impacting quality depending on the actual sound’s contents. See 最佳实践 for more information.

Edit > Trim

The source audio file may contain long silences at the beginning and/or the end. These silences are inserted by DAWs when saving to a waveform, which increases their size unnecessarily and add latency to the moment they are played back.

Enabling Trim will automatically trim the beginning and end of the audio if it’s lower than -50 dB after normalization (see Edit > Normalize below). A fade-in/fade-out period of 500 samples is also used during trimming to avoid audible pops.

Edit > Normalize

If enabled, audio volume will be normalized so that its peak volume is equal to 0 dB. When enabled, normalization will make audio sound louder depending on its original peak volume.

Edit > Loop Mode

Unlike Ogg Vorbis and MP3, WAV files can contain metadata to indicate whether they’re looping (in addition to loop points). By default, Godot will follow this metadata, but you can choose to apply a specific loop mode:

• Disabled: Don’t loop audio, even if metadata indicates the file should be played back looping.

• Forward: Standard audio looping.

• Ping-Pong: Play audio forward until it’s done playing, then play it backward and repeat. This is similar to mirrored texture repeat, but for audio.

• Backward: Play audio in reverse and loop back to the end when done playing.

When choosing one of the Forward, Ping-Pong or Backward loop modes, loop points can also be defined to make only a specific part of the sound loop. Loop Begin is set in samples after the beginning of the audio file. Loop End is also set in samples after the beginning of the audio file, but will use the end of the audio file if set to -1.

警告

In AudioStreamPlayer, the finished signal won’t be emitted for looping audio when it reaches the end of the audio file, as the audio will keep playing indefinitely.

压缩 > 模式

Two compression modes can be chosen for WAV files: Disabled (default) or RAM (Ima-ADPCM). RAM (Ima-ADPCM) reduces file size and memory usage a little, at the cost of decreasing quality in an audible manner.

Ogg Vorbis and MP3 don’t decrease quality as much and can provide greater file size reductions, at the cost of higher CPU usage during playback. This higher CPU usage is usually not a problem (especially with MP3), unless playing dozens of compressed sounds at the same time on mobile/web platforms.

导入选项（Ogg Vorbis 和 MP3）

循环

如果启用，播放至音频末尾后会从开头开始播放。

警告

In AudioStreamPlayer, the finished signal won’t be emitted for looping audio when it reaches the end of the audio file, as the audio will keep playing indefinitely.

循环偏移

The loop offset determines where audio will start to loop after playback reaches the end of the audio. This can be used to only loop a part of the audio file, which is useful for some ambient sounds or music. The value is determined in seconds relative to the beginning of the audio, so 0 will loop the entire audio file.

Only has an effect if Loop is enabled.

A more convenient editor for Loop Offset is provided in the Advanced import settings dialog, as it lets you preview your changes without having to reimport the audio.

BPM

The Beats Per Minute of the audio track. This should match the BPM measure that was used to compose the track. This is only relevant for music that wishes to make use of interactive music functionality (not implemented yet), not sound effects.

A more convenient editor for BPM is provided in the Advanced import settings dialog, as it lets you preview your changes without having to reimport the audio.

Beat Count

The beat count of the audio track. This is only relevant for music that wishes to make use of interactive music functionality (not implemented yet), not sound effects.

A more convenient editor for Beat Count is provided in the Advanced import settings dialog, as it lets you preview your changes without having to reimport the audio.

Bar Beats

The number of bars within a single beat in the audio track. This is only relevant for music that wishes to make use of interactive music functionality (not implemented yet), not sound effects.

A more convenient editor for Bar Beats is provided in the Advanced import settings dialog, as it lets you preview your changes without having to reimport the audio.

高级导入设置（Ogg Vorbis 和 MP3）

双击文件系统面板中的 Ogg Vorbis 或 MP3 文件（或者在导入面板中选择高级…），就会出现一个对话框：

双击文件系统面板中的 Ogg Vorbis 或 MP3 文件时的高级对话框

This dialog allows you to edit the audio’s loop point with a real-time preview, in addition to the BPM, beat count and bar beats. These 3 settings are currently unused, but they will be used in the future for interactive music support (which allows smoothly transitioning between different music tracks).

备注

Unlike WAV files, Ogg Vorbis and MP3 only support a “loop begin” loop point, not a “loop end” point. Looping can also be only be standard forward looping, not ping-pong or backward.

最佳实践

Use appropriate quality settings

While keeping pristine-quality audio sources is important if you’re performing editing, using the same quality in the exported project is not necessary. For WAV files, Godot offers several import options to reduce the final file size without modifying the source file on disk.

To reduce memory usage and file size, choose an appropriate quantization, sample rate and number of channels for your audio:

• There’s no audible benefit to using 24-bit audio, especially in a game where several sounds are often playing at the same time (which makes it harder to appreciate individual sounds).

• Unless you are slowing down the audio at run-time, there’s no audible benefit to using a sample rate greater than 48 kHz. If you wish to keep a source with a higher sample rate for editing, use the Force > Max Rate import option to limit the sample rate of the imported sound (only available for WAV files).

• Many sound effects can generally be converted to mono as opposed to stereo. If you wish to keep a source with stereo for editing, use the Force > Mono import option to convert the imported sound to mono (only available for WAV files).

• Voices can generally be converted to mono, but can also have their sample rate reduced to 22 kHz without a noticeable loss in quality (unless the voice is very high-pitched). This is because most human voices never go past 11 kHz.

使用实时音频效果降低文件大小

Godot 有一个庞大的总线系统，提供了内置的效果。因此 SFX 艺术家无需在音效中添加混响，从而大大缩减了文件大小并且能确保剪辑正确。

如上所示，音效在添加混响后文件大小会变得非常巨大。

参见

Audio samples can be loaded and saved at runtime using runtime file loading and saving, including from an exported project.

Previous Next

© 版权所有 2014-present Juan Linietsky, Ariel Manzur and the Godot community (CC BY 3.0). Revision b1c660f7.

Built with Sphinx using a theme provided by Read the Docs.