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

AudioEffectSpectrumAnalyzerInstance

继承： AudioEffectInstance < RefCounted < Object

AudioEffectSpectrumAnalyzer 的可查询实例。

描述

AudioEffectSpectrumAnalyzer 的运行时部分，可以用来查询宿主总线上某个频率范围内的幅度。

可以使用 AudioServer.get_bus_effect_instance() 获取该类的实例。

教程

音频频谱可视化演示

方法

Vector2

get_magnitude_for_frequency_range(from_hz: float, to_hz: float, mode: MagnitudeMode = 1) const

枚举

enum MagnitudeMode: 🔗

MagnitudeMode MAGNITUDE_AVERAGE = 0

使用频率范围内的平均值作为幅度。

MagnitudeMode MAGNITUDE_MAX = 1

使用频率范围内的最大值作为幅度。

方法说明

Vector2 get_magnitude_for_frequency_range(from_hz: float, to_hz: float, mode: MagnitudeMode = 1) const 🔗

返回从 from_hz 到 to_hz 频率范围内的幅度，使用线性能量单位，返回的是 Vector2。返回值的 x 分量代表左声道、y 分量代表右声道。

mode 决定的是频率范围的处理方式，见 MagnitudeMode。