AudioEffectRecord

繼承： AudioEffect < Resource < RefCounted < Object

用於錄製音訊匯流排輸出的音訊效果。

說明

可將音訊匯流排的聲音錄製成 AudioStreamWAV。若用於「Master」匯流排，將包含 Godot 全部音訊輸出。

與 AudioEffectCapture 不同，此效果會依指定格式（8-bit、16-bit 或壓縮）編碼錄音，而非提供原始取樣資料。

亦可搭配 AudioStreamMicrophone 進行麥克風錄音。

注意：必須將 ProjectSettings.audio/driver/enable_input 設為 true 才能使用音訊輸入。更多權限及作業系統隱私限制請參閱該設定說明。

教學

• 使用麥克風錄音

• 音訊麥克風錄音示範

屬性

Format

format

1

方法

AudioStreamWAV	get_recording() const
bool	is_recording_active() const
void	set_recording_active(record: bool)

---

屬性說明

Format format = 1 🔗

• void set_format(value: Format)

• Format get_format()

指定錄音所使用的格式。

---

方法說明

AudioStreamWAV get_recording() const 🔗

返回錄製的樣本。

---

bool is_recording_active() const 🔗

返回錄音是否啟動。

---

void set_recording_active(record: bool) 🔗

若為 true 則開始錄音；重新開始會刪除先前錄得的樣本。