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

AudioEffect

Наследует: Resource < RefCounted < Object

Наследуется от: AudioEffectAmplify, AudioEffectCapture, AudioEffectChorus, AudioEffectCompressor, AudioEffectDelay, AudioEffectDistortion, AudioEffectEQ, AudioEffectFilter, AudioEffectHardLimiter, AudioEffectLimiter, AudioEffectPanner, AudioEffectPhaser, AudioEffectPitchShift, AudioEffectRecord, AudioEffectReverb, AudioEffectSpectrumAnalyzer, AudioEffectStereoEnhance

Базовый класс для ресурсов аудиоэффектов.

Описание

Базовый Resource для каждого звукового эффекта. В редакторе звуковой эффект можно добавить к текущей схеме шины через панель «Аудио». Во время выполнения также можно управлять звуковыми эффектами с помощью AudioServer.add_bus_effect(), AudioServer.remove_bus_effect() и AudioServer.get_bus_effect().

При применении к шине звуковой эффект создает соответствующий AudioEffectInstance. Этот экземпляр напрямую отвечает за управление звуком на основе свойств исходного звукового эффекта.

Обучающие материалы

• Аудиошины

• Звуковые эффекты

• Демонстрация записи аудио с микрофона

Методы

AudioEffectInstance

_instantiate() virtual required

---

Описания метода

AudioEffectInstance _instantiate() virtual required 🔗

Переопределите этот метод, чтобы настроить AudioEffectInstance, создаваемый при применении этого эффекта к шине на панели «Аудио» редактора или через AudioServer.add_bus_effect().

extends AudioEffect

@export var strength = 4.0

func _instantiate():
    var effect = CustomAudioEffectInstance.new()
    effect.base = self

    return effect

Примечание: Рекомендуется сохранить ссылку на оригинальный AudioEffect в новом экземпляре. В зависимости от реализации это позволяет экземпляру эффекта прослушивать изменения во время выполнения и изменяться соответствующим образом.