mirror of
https://github.com/godotengine/godot-docs-l10n.git
synced 2026-01-04 10:09:56 +03:00
214 lines
15 KiB
ReStructuredText
214 lines
15 KiB
ReStructuredText
:github_url: hide
|
||
|
||
.. _class_ResourceImporterWAV:
|
||
|
||
ResourceImporterWAV
|
||
===================
|
||
|
||
**Наследует:** :ref:`ResourceImporter<class_ResourceImporter>` **<** :ref:`RefCounted<class_RefCounted>` **<** :ref:`Object<class_Object>`
|
||
|
||
Импортирует аудиофайл WAV для воспроизведения.
|
||
|
||
.. rst-class:: classref-introduction-group
|
||
|
||
Описание
|
||
----------------
|
||
|
||
WAV — это несжатый формат, который может обеспечить более высокое качество по сравнению с Ogg Vorbis и MP3. Он также имеет самые низкие затраты ЦП на декодирование. Это означает, что большое количество звуков WAV может воспроизводиться одновременно, даже на устройствах низкого уровня.
|
||
|
||
По умолчанию Godot импортирует файлы WAV, используя сжатие Quite OK Audio с потерями. Вы можете изменить это, установив свойство :ref:`compress/mode<class_ResourceImporterWAV_property_compress/mode>`.
|
||
|
||
.. rst-class:: classref-introduction-group
|
||
|
||
Обучающие материалы
|
||
--------------------------------------
|
||
|
||
- :doc:`Импорт аудиосэмплов <../tutorials/assets_pipeline/importing_audio_samples>`
|
||
|
||
.. rst-class:: classref-reftable-group
|
||
|
||
Свойства
|
||
----------------
|
||
|
||
.. table::
|
||
:widths: auto
|
||
|
||
+---------------------------+--------------------------------------------------------------------------------+-----------+
|
||
| :ref:`int<class_int>` | :ref:`compress/mode<class_ResourceImporterWAV_property_compress/mode>` | ``2`` |
|
||
+---------------------------+--------------------------------------------------------------------------------+-----------+
|
||
| :ref:`int<class_int>` | :ref:`edit/loop_begin<class_ResourceImporterWAV_property_edit/loop_begin>` | ``0`` |
|
||
+---------------------------+--------------------------------------------------------------------------------+-----------+
|
||
| :ref:`int<class_int>` | :ref:`edit/loop_end<class_ResourceImporterWAV_property_edit/loop_end>` | ``-1`` |
|
||
+---------------------------+--------------------------------------------------------------------------------+-----------+
|
||
| :ref:`int<class_int>` | :ref:`edit/loop_mode<class_ResourceImporterWAV_property_edit/loop_mode>` | ``0`` |
|
||
+---------------------------+--------------------------------------------------------------------------------+-----------+
|
||
| :ref:`bool<class_bool>` | :ref:`edit/normalize<class_ResourceImporterWAV_property_edit/normalize>` | ``false`` |
|
||
+---------------------------+--------------------------------------------------------------------------------+-----------+
|
||
| :ref:`bool<class_bool>` | :ref:`edit/trim<class_ResourceImporterWAV_property_edit/trim>` | ``false`` |
|
||
+---------------------------+--------------------------------------------------------------------------------+-----------+
|
||
| :ref:`bool<class_bool>` | :ref:`force/8_bit<class_ResourceImporterWAV_property_force/8_bit>` | ``false`` |
|
||
+---------------------------+--------------------------------------------------------------------------------+-----------+
|
||
| :ref:`bool<class_bool>` | :ref:`force/max_rate<class_ResourceImporterWAV_property_force/max_rate>` | ``false`` |
|
||
+---------------------------+--------------------------------------------------------------------------------+-----------+
|
||
| :ref:`float<class_float>` | :ref:`force/max_rate_hz<class_ResourceImporterWAV_property_force/max_rate_hz>` | ``44100`` |
|
||
+---------------------------+--------------------------------------------------------------------------------+-----------+
|
||
| :ref:`bool<class_bool>` | :ref:`force/mono<class_ResourceImporterWAV_property_force/mono>` | ``false`` |
|
||
+---------------------------+--------------------------------------------------------------------------------+-----------+
|
||
|
||
.. rst-class:: classref-section-separator
|
||
|
||
----
|
||
|
||
.. rst-class:: classref-descriptions-group
|
||
|
||
Описания свойств
|
||
--------------------------------
|
||
|
||
.. _class_ResourceImporterWAV_property_compress/mode:
|
||
|
||
.. rst-class:: classref-property
|
||
|
||
:ref:`int<class_int>` **compress/mode** = ``2`` :ref:`🔗<class_ResourceImporterWAV_property_compress/mode>`
|
||
|
||
Режим сжатия, используемый при импорте.
|
||
|
||
- **PCM (несжатый):** Импортирует аудиоданные без какой-либо формы сжатия, сохраняя максимально возможное качество. Он имеет самую низкую загрузку ЦП, но самое большое использование памяти.
|
||
|
||
- **IMA ADPCM:** Применяет быстрое сжатие с потерями во время импорта, заметно снижая качество, но с низкой загрузкой ЦП и использованием памяти. Не поддерживает поиск, поддерживается только режим прямого цикла.
|
||
|
||
- **\ `Довольно неплохой звук <https://qoaformat.org/>`__:** Также применяет сжатие с потерями при импорте, имея немного большую загрузку ЦП по сравнению с IMA ADPCM, но гораздо более высокое качество и самое низкое использование памяти.
|
||
|
||
.. rst-class:: classref-item-separator
|
||
|
||
----
|
||
|
||
.. _class_ResourceImporterWAV_property_edit/loop_begin:
|
||
|
||
.. rst-class:: classref-property
|
||
|
||
:ref:`int<class_int>` **edit/loop_begin** = ``0`` :ref:`🔗<class_ResourceImporterWAV_property_edit/loop_begin>`
|
||
|
||
Начальная точка цикла, используемая, когда :ref:`edit/loop_mode<class_ResourceImporterWAV_property_edit/loop_mode>` — **Forward**, **Ping-Pong** или **Backward**. Это устанавливается в сэмплах после начала аудиофайла.
|
||
|
||
.. rst-class:: classref-item-separator
|
||
|
||
----
|
||
|
||
.. _class_ResourceImporterWAV_property_edit/loop_end:
|
||
|
||
.. rst-class:: classref-property
|
||
|
||
:ref:`int<class_int>` **edit/loop_end** = ``-1`` :ref:`🔗<class_ResourceImporterWAV_property_edit/loop_end>`
|
||
|
||
Конечная точка цикла, используемая, когда :ref:`edit/loop_mode<class_ResourceImporterWAV_property_edit/loop_mode>` — **Forward**, **Ping-Pong** или **Backward**. Это устанавливается в сэмплах после начала аудиофайла. Значение ``-1`` использует конец аудиофайла в качестве конечной точки цикла.
|
||
|
||
.. rst-class:: classref-item-separator
|
||
|
||
----
|
||
|
||
.. _class_ResourceImporterWAV_property_edit/loop_mode:
|
||
|
||
.. rst-class:: classref-property
|
||
|
||
:ref:`int<class_int>` **edit/loop_mode** = ``0`` :ref:`🔗<class_ResourceImporterWAV_property_edit/loop_mode>`
|
||
|
||
Управляет тем, как аудио должно циклически воспроизводиться.
|
||
|
||
- **Определить из WAV:** Использует информацию о цикле из метаданных WAV.
|
||
|
||
- **Отключено:** Не зацикливать аудио, даже если метаданные указывают, что воспроизведение файла должно циклически воспроизводиться.
|
||
|
||
- **Вперед:** Стандартное циклическое воспроизведение аудио. Воспроизводит аудио вперед с начала до :ref:`edit/loop_end<class_ResourceImporterWAV_property_edit/loop_end>`, затем возвращается к :ref:`edit/loop_begin<class_ResourceImporterWAV_property_edit/loop_begin>` и повторяет.
|
||
|
||
- **Пинг-понг:** Воспроизводит аудио вперед до :ref:`edit/loop_end<class_ResourceImporterWAV_property_edit/loop_end>`, затем назад до :ref:`edit/loop_begin<class_ResourceImporterWAV_property_edit/loop_begin>`, повторяя этот цикл.
|
||
|
||
- **Назад:** Воспроизводит аудио назад от :ref:`edit/loop_end<class_ResourceImporterWAV_property_edit/loop_end>` до :ref:`edit/loop_begin<class_ResourceImporterWAV_property_edit/loop_begin>`, затем повторяет.
|
||
|
||
\ **Примечание:** В :ref:`AudioStreamPlayer<class_AudioStreamPlayer>` сигнал :ref:`AudioStreamPlayer.finished<class_AudioStreamPlayer_signal_finished>` не будет выдаваться для зацикливания звука при достижении конца аудиофайла, поскольку звук будет воспроизводиться бесконечно.
|
||
|
||
.. rst-class:: classref-item-separator
|
||
|
||
----
|
||
|
||
.. _class_ResourceImporterWAV_property_edit/normalize:
|
||
|
||
.. rst-class:: classref-property
|
||
|
||
:ref:`bool<class_bool>` **edit/normalize** = ``false`` :ref:`🔗<class_ResourceImporterWAV_property_edit/normalize>`
|
||
|
||
Если ``true``, нормализовать громкость звука так, чтобы ее пиковая громкость была равна 0 дБ. При включении нормализация сделает звук громче в зависимости от его исходной пиковой громкости.
|
||
|
||
.. rst-class:: classref-item-separator
|
||
|
||
----
|
||
|
||
.. _class_ResourceImporterWAV_property_edit/trim:
|
||
|
||
.. rst-class:: classref-property
|
||
|
||
:ref:`bool<class_bool>` **edit/trim** = ``false`` :ref:`🔗<class_ResourceImporterWAV_property_edit/trim>`
|
||
|
||
Если ``true``, автоматически обрезает начало и конец аудио, если оно ниже -50 дБ после нормализации (см. :ref:`edit/normalize<class_ResourceImporterWAV_property_edit/normalize>`). Это предотвращает наличие файлов с тишиной в начале или конце, что увеличивает их размер без необходимости и добавляет задержку к моменту воспроизведения. Во время обрезки также используется период нарастания/затухания, равный 500 сэмплам, чтобы избежать слышимых хлопков.
|
||
|
||
.. rst-class:: classref-item-separator
|
||
|
||
----
|
||
|
||
.. _class_ResourceImporterWAV_property_force/8_bit:
|
||
|
||
.. rst-class:: classref-property
|
||
|
||
:ref:`bool<class_bool>` **force/8_bit** = ``false`` :ref:`🔗<class_ResourceImporterWAV_property_force/8_bit>`
|
||
|
||
Если ``true``, импортированное аудио будет использовать 8-битную квантизацию, если исходный файл 16-битный или выше.
|
||
|
||
Включение этого параметра обычно не рекомендуется, так как 8-битная квантизация значительно снижает качество звука. Если вам нужны файлы меньшего размера, рассмотрите возможность использования вместо этого аудио Ogg Vorbis или MP3.
|
||
|
||
.. rst-class:: classref-item-separator
|
||
|
||
----
|
||
|
||
.. _class_ResourceImporterWAV_property_force/max_rate:
|
||
|
||
.. rst-class:: classref-property
|
||
|
||
:ref:`bool<class_bool>` **force/max_rate** = ``false`` :ref:`🔗<class_ResourceImporterWAV_property_force/max_rate>`
|
||
|
||
Если установлено значение больше ``0``, частота дискретизации аудио будет снижена до значения ниже или равного значению, указанному в :ref:`force/max_rate_hz<class_ResourceImporterWAV_property_force/max_rate_hz>`.
|
||
|
||
Это может заметно уменьшить размер файла для определенных звуков, не влияя на качество в зависимости от фактического содержимого звука. См. `Лучшие практики <../tutorials/assets_pipeline/importing_audio_samples.html#doc-importing-audio-samples-best-practices>`__ для получения дополнительной информации.
|
||
|
||
.. rst-class:: classref-item-separator
|
||
|
||
----
|
||
|
||
.. _class_ResourceImporterWAV_property_force/max_rate_hz:
|
||
|
||
.. rst-class:: classref-property
|
||
|
||
:ref:`float<class_float>` **force/max_rate_hz** = ``44100`` :ref:`🔗<class_ResourceImporterWAV_property_force/max_rate_hz>`
|
||
|
||
Частота, которой ограничивается импортируемый аудиосэмпл (в Гц). Действует только если :ref:`force/max_rate<class_ResourceImporterWAV_property_force/max_rate>` равно ``true``.
|
||
|
||
.. rst-class:: classref-item-separator
|
||
|
||
----
|
||
|
||
.. _class_ResourceImporterWAV_property_force/mono:
|
||
|
||
.. rst-class:: classref-property
|
||
|
||
:ref:`bool<class_bool>` **force/mono** = ``false`` :ref:`🔗<class_ResourceImporterWAV_property_force/mono>`
|
||
|
||
Если ``true``, то импортированное аудио становится моно, если исходный файл — стерео. Это уменьшает размер файла на 50% за счет объединения двух каналов в один.
|
||
|
||
.. |virtual| replace:: :abbr:`virtual (Этот метод обычно должен быть переопределен пользователем, чтобы иметь какой-либо эффект.)`
|
||
.. |required| replace:: :abbr:`required (This method is required to be overridden when extending its base class.)`
|
||
.. |const| replace:: :abbr:`const (Этот метод не имеет побочных эффектов. Он не изменяет ни одну из переменных-членов экземпляра.)`
|
||
.. |vararg| replace:: :abbr:`vararg (Этот метод принимает любое количество аргументов после описанных здесь.)`
|
||
.. |constructor| replace:: :abbr:`constructor (Этот метод используется для создания типа.)`
|
||
.. |static| replace:: :abbr:`static (Этот метод не нуждается в вызове экземпляра, поэтому его можно вызвать напрямую, используя имя класса.)`
|
||
.. |operator| replace:: :abbr:`operator (Этот метод описывает допустимый оператор для использования с этим типом в качестве левого операнда.)`
|
||
.. |bitfield| replace:: :abbr:`BitField (Это значение является целым числом, составленным как битовая маска следующих флагов.)`
|
||
.. |void| replace:: :abbr:`void (Нет возвращаемого значения.)`
|