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.

AudioEffectSpectrumAnalyzer

繼承: AudioEffect < Resource < RefCounted < Object

建立一個 AudioEffectInstance,用於執行頻率分析並公開結果,以便進行即時存取。

說明

計算音訊訊號的傅里葉變換。該效果不會改變音訊本身。可用於建立即時音訊視覺化效果,例如頻譜圖。

該資源設定了一個 AudioEffectSpectrumAnalyzerInstance,會在執行時執行實際的分析工作。要使用該效果,需要使用 AudioServer.get_bus_effect_instance() 取得實例。

教學

屬性

float

buffer_length

2.0

FFTSize

fft_size

2


列舉

enum FFTSize: 🔗

FFTSize FFT_SIZE_256 = 0

使用 256 個取樣點進行快速傅立葉轉換。延遲最低,但長時間穩定性最差。

FFTSize FFT_SIZE_512 = 1

使用 512 個取樣點進行快速傅立葉轉換。延遲低,但長時間穩定性較差。

FFTSize FFT_SIZE_1024 = 2

使用 1024 個取樣點進行快速傅立葉轉換。延遲與穩定性折衷。

FFTSize FFT_SIZE_2048 = 3

使用 2048 個取樣點進行快速傅立葉轉換。延遲高,但穩定。

FFTSize FFT_SIZE_4096 = 4

使用 4096 個取樣點進行快速傅立葉轉換。延遲最高,但穩定性最佳。

FFTSize FFT_SIZE_MAX = 5

代表 FFTSize 列舉的大小。


屬性說明

float buffer_length = 2.0 🔗

  • void set_buffer_length(value: float)

  • float get_buffer_length()

要保留的緩衝區長度,單位為秒。值越大,資料保留時間越長,但所需的記憶體也越多。取值範圍為 0.1 至 4。


FFTSize fft_size = 2 🔗

快速傅立葉轉換緩衝區大小。值越高頻譜分析隨時間越平滑,但延遲也越大;突發振幅變化時此延遲特別明顯。