ResourceImporterWAV

Наследует: ResourceImporter < RefCounted < Object

Импортирует аудиофайл WAV для воспроизведения.

Описание

WAV — это несжатый формат, который может обеспечить более высокое качество по сравнению с Ogg Vorbis и MP3. Он также имеет самые низкие затраты ЦП на декодирование. Это означает, что большое количество звуков WAV может воспроизводиться одновременно, даже на устройствах низкого уровня.

По умолчанию Godot импортирует файлы WAV, используя сжатие Quite OK Audio с потерями. Вы можете изменить это, установив свойство 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 (несжатый): Импортирует аудиоданные без какой-либо формы сжатия, сохраняя максимально возможное качество. Он имеет самую низкую загрузку ЦП, но самое большое использование памяти.

  • IMA ADPCM: Применяет быстрое сжатие с потерями во время импорта, заметно снижая качество, но с низкой загрузкой ЦП и использованием памяти. Не поддерживает поиск, поддерживается только режим прямого цикла.

  • `Довольно неплохой звук <https://qoaformat.org/>`__: Также применяет сжатие с потерями при импорте, имея немного большую загрузку ЦП по сравнению с 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 🔗

Управляет тем, как аудио должно циклически воспроизводиться.

  • Определить из WAV: Использует информацию о цикле из метаданных WAV.

  • Отключено: Не зацикливать аудио, даже если метаданные указывают, что воспроизведение файла должно циклически воспроизводиться.

  • Вперед: Стандартное циклическое воспроизведение аудио. Воспроизводит аудио вперед с начала до edit/loop_end, затем возвращается к edit/loop_begin и повторяет.

  • Пинг-понг: Воспроизводит аудио вперед до edit/loop_end, затем назад до edit/loop_begin, повторяя этот цикл.

  • Назад: Воспроизводит аудио назад от edit/loop_end до edit/loop_begin, затем повторяет.

Примечание: В AudioStreamPlayer сигнал AudioStreamPlayer.finished не будет выдаваться для зацикливания звука при достижении конца аудиофайла, поскольку звук будет воспроизводиться бесконечно.

bool edit/normalize = false 🔗

Если true, нормализовать громкость звука так, чтобы ее пиковая громкость была равна 0 дБ. При включении нормализация сделает звук громче в зависимости от его исходной пиковой громкости.

bool edit/trim = false 🔗

Если true, автоматически обрезает начало и конец аудио, если оно ниже -50 дБ после нормализации (см. edit/normalize). Это предотвращает наличие файлов с тишиной в начале или конце, что увеличивает их размер без необходимости и добавляет задержку к моменту воспроизведения. Во время обрезки также используется период нарастания/затухания, равный 500 сэмплам, чтобы избежать слышимых хлопков.

bool force/8_bit = false 🔗

Если true, импортированное аудио будет использовать 8-битную квантизацию, если исходный файл 16-битный или выше.

Включение этого параметра обычно не рекомендуется, так как 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% за счет объединения двух каналов в один.