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.

AudioEffectInstance

繼承: RefCounted < Object

被繼承: AudioEffectSpectrumAnalyzerInstance

處理對應效果所接收的音訊。

說明

音訊效果實例會針對對應效果處理其接收的音訊。該實例於 AudioEffect 加入匯流排時自動建立,一般不應手動建立;如有需要,可於執行時透過 AudioServer.get_bus_effect_instance() 取得。

教學

方法

void

_process(src_buffer: const void*, r_dst_buffer: AudioFrame*, frame_count: int) virtual required

bool

_process_silence() virtual const


方法說明

void _process(src_buffer: const void*, r_dst_buffer: AudioFrame*, frame_count: int) virtual required 🔗

此方法由 AudioServer 呼叫以處理此效果。若未覆寫 _process_silence() 或其回傳值為 false,僅當匯流排處於作用狀態時才會被呼叫。

注意: 在 GDScript 或 C# 中覆寫本方法並無實際效益;只有以 GDExtension 實作時才能發揮效用。


bool _process_silence() virtual const 🔗

覆寫此方法可自訂此效果實例的處理行為。

若回傳 true,將強制 AudioServer 無論匯流排是否靜音或不可聽見,都持續呼叫 _process()