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...
AudioListener3D
覆寫聽音位置。
說明
加入場景樹並透過 make_current() 啟用後,此節點將覆寫聽音位置,可用於從與 Camera3D 不同的位置聽取聲音。
屬性
|
方法
void |
|
get_listener_transform() const |
|
is_current() const |
|
void |
列舉
enum DopplerTracking: 🔗
DopplerTracking DOPPLER_TRACKING_DISABLED = 0
停用多普勒效應模擬(預設)。
DopplerTracking DOPPLER_TRACKING_IDLE_STEP = 1
通過在 _process 中追蹤物件位置的變化,來模擬 Doppler effect 。這個監聽器(listener)與那些物件之間的相對速度變化,會影響音訊的聽感(具體表現為改變音訊的 AudioStreamPlayer3D.pitch_scale 屬性)。
DopplerTracking DOPPLER_TRACKING_PHYSICS_STEP = 2
通過在 _physics_process 中追蹤物體位置的變化,來模擬 Doppler effect。該監聽器(listener)與這些物體之間的相對速度變化,會影響音訊的聽感(具體表現為改變音訊的 AudioStreamPlayer3D.pitch_scale 屬性)。
屬性說明
DopplerTracking doppler_tracking = 0 🔗
void set_doppler_tracking(value: DopplerTracking)
DopplerTracking get_doppler_tracking()
如果不是 DOPPLER_TRACKING_DISABLED,則該監聽器將在特定的 _process 方法中,為變化的物件模擬多普勒效應。
注意:多普勒效應僅在 AudioStreamPlayer3D.doppler_tracking 未設定為 AudioStreamPlayer3D.DOPPLER_TRACKING_DISABLED 時才會在 AudioStreamPlayer3D 上聽到。
方法說明
void clear_current() 🔗
停用此監聽器,改用目前相機的監聽器。
Transform3D get_listener_transform() const 🔗
返回監聽器的全域正交化 Transform3D。
若監聽器透過 make_current() 設為目前則返回 true,否則返回 false。
注意:場景樹中可同時標記多個 AudioListener3D 為「目前」,但僅最後設定者實際生效。
void make_current() 🔗
啟用此監聽器,並覆寫目前相機的監聽器。