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...

ResourceImporterMP3

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

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

Опис

MP3 - це випадковий аудіо формат, з гіркою якістю звуку порівняно з ResourceImporterOggVorbis при наданій бітрейт.

У більшості випадків рекомендується використовувати Ogg Vorbis над MP3. Однак, якщо ви використовуєте джерело звуку MP3 без джерела високої якості, то рекомендується використовувати файл MP3 безпосередньо для уникнення подвійного стиснення.

MP3 вимагає більшого розміру процесора, ніж ResourceImporterWAV. Якщо ви повинні грати багато одночасних звуків, рекомендується використовувати WAV для тих звуків замість цього, особливо якщо ціль невисоких пристроїв.

Посібники

Властивості

int

bar_beats

4

int

beat_count

0

float

bpm

0

bool

loop

false

float

loop_offset

0

Описи властивостей

int bar_beats = 4 🔗

Кількість ударів у одному такті аудіодоріжки. Цей параметр актуальний лише для музичних файлів, у яких передбачено використання функцій інтерактивної музики, а не для звукових ефектів.

У діалоговому вікні Розширені налаштування імпорту передбачено більш зручний редактор для параметра bar_beats, оскільки він дозволяє переглянути зміни без необхідності повторного імпорту аудіофайлу.

int beat_count = 0 🔗

Тривалість аудіодоріжки у тактах. Фактична тривалість аудіофайлу може перевищувати значення, вказане в цьому параметрі. Це стосується лише музичних композицій, для яких передбачено використання функцій інтерактивної музики, а не звукових ефектів.

У діалоговому вікні Додаткові налаштування імпорту передбачено більш зручний редактор для параметра beat_count, оскільки він дозволяє переглянути зміни без необхідності повторного імпорту аудіофайлу.

float bpm = 0 🔗

Темп аудіодоріжки, що вимірюється в ударах на хвилину. Він повинен відповідати значенню BPM, яке використовувалося під час створення доріжки. Це актуально лише для музики, для якої передбачено використання функцій інтерактивної музики, а не для звукових ефектів.

У діалоговому вікні Розширені налаштування імпорту передбачено більш зручний редактор для параметра bpm, оскільки він дозволяє переглянути зміни без необхідності повторного імпорту аудіо.

bool loop = false 🔗

Якщо ця опція увімкнена, відтворення аудіо розпочнеться або з початку, або з позиції loop_offset після завершення відтворення, яке відбувається або після досягнення кінця аудіофайлу, або після досягнення кінця останнього такту відповідно до значення, вказаного в beat_count.

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

float loop_offset = 0 🔗

Визначає, де почнеться зациклення аудіо після того, як відтворення досягне кінця. Це можна використовувати для зациклення лише частини аудіофайлу, що корисно для деяких навколишніх звуків або музики. Значення визначається в секундах відносно початку аудіо. Значення 0.0 зациклить весь аудіофайл.

Має ефект лише тоді, коли loop має значення true.

Зручніший редактор для loop_offset надається в діалоговому вікні Додаткові налаштування імпорту, оскільки він дозволяє переглядати зміни без необхідності повторного імпорту аудіо.