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

Звукові потоки

Вступ

Як ви, можливо, вже читали в статті Звукові шини, звук надсилається на кожну шину через вузол AudioStreamPlayer. Існують різні типи цього вузла. Кожен з них завантажує AudioStream (Звуковий потік) і відтворює його.

АудіоПотік

AudioStream (Звуковий потік) - це абстрактний об'єкт, який випромінює звук. Звук може надходити з багатьох місць, але найчастіше завантажується з файлової системи. Аудіо-файли можуть завантажуватися як Звукові потоки і розміщуватися всередині вузла AudioStreamPlayer. Ви можете знайти інформацію про підтримувані формати та їх відмінності в Імпорт аудіо нарізків.

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

Програвач аудіопотоку

Це стандартний програвач звукового потоку. Він може відтворюватися на будь-якій шині. При параметрі звуку в 5,1, він може надсилати звук на стереомікс, або передні динаміки.

Тип відтворення є експериментальним налаштуванням і може змінитися в наступних версіях Godot. Він існує, тому веб-експорт використовує зразки на основі Web Audio-API замість потокового передавання всіх звуків у браузер, на відміну від більшості платформ. Це запобігає спотворенню звуку під час однопотокового веб-експорту. За замовчуванням лише веб-платформа використовуватиме зразки. Змінювати цей параметр не рекомендується, якщо у вас немає чіткої причини. Ви можете змінити тип відтворення за замовчуванням для Інтернету та інших платформ у налаштуваннях проекту в розділі Аудіо > Загальні (для перегляду цього налаштування потрібно ввімкнути розширені налаштування).

Програвач аудіопотоку 2D

Це варіант AudioStreamPlayer, але видає звук в 2D середовищі. При розміщенні джерела звуку з лівого краю екрана звук буде поширюватися вліво. З правого - вправо.

Примітка

Area2D (Області 2Д) можна використовувати для перенаправлення звуку від будь-яких AudioStreamPlayer2D, які розміщені на конкретних шинах. Це дозволяє створювати шини з різними ревербераційними, або звуковими, якостями для обробки дій, що відбуваються в певних частинах вашого ігрового світу.

Програвач аудіопотоку 3D

Це варіант AudioStreamPlayer, але випромінює звук в 3D середовищі. Залежно від розташування програвача відносно екрану, він може поширювати звук в стерео, 5,1, або 7,1, в залежності від обраної настройки звуку.

Подібно до AudioStreamPlayer2D, Area3D може перенаправляти звук на аудіошину.

На відміну від 2D, 3D-версія AudioStreamPlayer має ще кілька додаткових опцій:

Шини реверберації

Попередження

This feature is not supported on the web platform if the AudioStreamPlayer's playback mode is set to Sample, which is the default. It will only work if the playback mode is set to Stream, at the cost of increased latency if threads are not enabled.

See Audio playback in the Exporting for the Web documentation for details.

Godot дозволяє 3D-аудіопотоки, які надходять до певного вузла Area3D, щоб надсилати сухий і вологий звук на окремі шини. Це корисно, якщо у вас є кілька конфігурацій реверберації для різних типів кімнат. Це робиться шляхом увімкнення цього типу реверберації в розділі Reverb Bus у властивостях Area3D:

У той же час створюється спеціальна розкладка шини, де кожен Area3D отримує інформацію про реверберацію від кожного Area3D. Ефект реверберації необхідно створити та налаштувати в кожній шині реверберації, щоб завершити налаштування бажаного ефекту:

У розділі Reverb Bus Area3D також є параметр під назвою Uniformity. Деякі типи приміщень відбивають звуки сильніше, ніж інші (наприклад, склад), тому реверберацію чути майже рівномірно по всій кімнаті, навіть якщо джерело може бути далеко. Погравши з цим параметром, можна імітувати цей ефект.

Доплер

Попередження

This feature is not supported on the web platform if the AudioStreamPlayer's playback mode is set to Sample, which is the default. It will only work if the playback mode is set to Stream, at the cost of increased latency if threads are not enabled.

See Audio playback in the Exporting for the Web documentation for details.

Коли відносна швидкість між випромінювачем і слухачем змінюється, це сприймається як збільшення, або зменшення, тону випромінюваного звуку. Godot може відстежувати зміни швидкості в вузлах AudioStreamPlayer3D і Camera. Обидва вузли мають цю властивість, яку потрібно ввімкнути вручну:

В залежності від того, як будуть переміщені об'єкти встановлюйте: Idle для об'єктів, переміщених за допомогою _process, або Physics для об'єктів, переміщених за допомогою _physics_process. Відстеження відбуватиметься автоматично.