ResourceImporterWAV

Успадковує: ResourceImporter < RefCounted < Object

Імпорт аудіофайлу WAV для відтворення.

Опис

WAV — це нестиснутий формат, який може забезпечити вищу якість порівняно з Ogg Vorbis і MP3. Він також має найнижчу вартість процесора для декодування. Це означає, що велика кількість звуків WAV може відтворюватися одночасно, навіть на пристроях низького класу.

За замовчуванням Godot імпортує файли 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 (без стиснення): імпортує аудіодані без будь-якої форми стиснення, зберігаючи найвищу можливу якість. Він має найнижчу вартість ЦП, але найбільше використання пам’яті.

  • 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 dB після нормалізації (див. 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.

Це може зменшити розмір файлу помітно на певних звуках, не впливаючи якість в залежності від фактичного вмісту звуку. Див. ` Найкращі практики <../tutorials/assets_pipeline/importing_audio_samples.html#doc-importing-audio-samples-best-practices>`__ для отримання додаткової інформації.

float force/max_rate_hz = 44100 🔗

Частота для обмеження імпортного аудіопрокату (в Гц). true.

bool force/mono = false 🔗

Якщо true, змушує імпортувати аудіо, щоб бути моно, якщо вихідний файл є стерео. Це зменшує розмір файлу на 50%, збільшуючи два канали в одну.