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. Існують різні типи AudioStreamPlayer. Кожен з них завантажує AudioStream та відтворює його.

АудіоПотік

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

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

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

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

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

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

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

Примітка

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

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

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

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

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

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

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

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

Див. Audio playback in the Exporting for the Web documentation для отримання додаткової інформації.

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

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

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

Доплер

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

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

Див. Audio playback in the Exporting for the Web documentation для отримання додаткової інформації.

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

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