diff --git a/doc/classes/AudioListener3D.xml b/doc/classes/AudioListener3D.xml
index c9de089195..b764b9aae5 100644
--- a/doc/classes/AudioListener3D.xml
+++ b/doc/classes/AudioListener3D.xml
@@ -35,4 +35,21 @@
+
+
+ If not [constant DOPPLER_TRACKING_DISABLED], this listener will simulate the [url=https://en.wikipedia.org/wiki/Doppler_effect]Doppler effect[/url] for objects changed in particular [code]_process[/code] methods.
+ [b]Note:[/b] The Doppler effect will only be heard on [AudioStreamPlayer3D]s if [member AudioStreamPlayer3D.doppler_tracking] is not set to [constant AudioStreamPlayer3D.DOPPLER_TRACKING_DISABLED].
+
+
+
+
+ Disables [url=https://en.wikipedia.org/wiki/Doppler_effect]Doppler effect[/url] simulation (default).
+
+
+ Simulate [url=https://en.wikipedia.org/wiki/Doppler_effect]Doppler effect[/url] by tracking positions of objects that are changed in [code]_process[/code]. Changes in the relative velocity of this listener compared to those objects affect how audio is perceived (changing the audio's [member AudioStreamPlayer3D.pitch_scale]).
+
+
+ Simulate [url=https://en.wikipedia.org/wiki/Doppler_effect]Doppler effect[/url] by tracking positions of objects that are changed in [code]_physics_process[/code]. Changes in the relative velocity of this listener compared to those objects affect how audio is perceived (changing the audio's [member AudioStreamPlayer3D.pitch_scale]).
+
+
diff --git a/doc/classes/AudioStreamPlayer3D.xml b/doc/classes/AudioStreamPlayer3D.xml
index 718f0e149c..51e5f6c52c 100644
--- a/doc/classes/AudioStreamPlayer3D.xml
+++ b/doc/classes/AudioStreamPlayer3D.xml
@@ -74,6 +74,7 @@
Decides in which step the Doppler effect should be calculated.
+ [b]Note:[/b] If [member doppler_tracking] is not [constant DOPPLER_TRACKING_DISABLED] but the current [Camera3D]/[AudioListener3D] has doppler tracking disabled, the Doppler effect will be heard but will not take the movement of the current listener into account. If accurate Doppler effect is desired, doppler tracking should be enabled on both the [AudioStreamPlayer3D] and the current [Camera3D]/[AudioListener3D].
The angle in which the audio reaches a listener unattenuated.
diff --git a/doc/classes/Camera3D.xml b/doc/classes/Camera3D.xml
index b24cdfd462..d7ef4320ce 100644
--- a/doc/classes/Camera3D.xml
+++ b/doc/classes/Camera3D.xml
@@ -175,6 +175,7 @@
If not [constant DOPPLER_TRACKING_DISABLED], this camera will simulate the [url=https://en.wikipedia.org/wiki/Doppler_effect]Doppler effect[/url] for objects changed in particular [code]_process[/code] methods.
+ [b]Note:[/b] The Doppler effect will only be heard on [AudioStreamPlayer3D]s if [member AudioStreamPlayer3D.doppler_tracking] is not set to [constant AudioStreamPlayer3D.DOPPLER_TRACKING_DISABLED].
The [Environment] to use for this camera.
diff --git a/scene/3d/audio_listener_3d.cpp b/scene/3d/audio_listener_3d.cpp
index 4a18447b3b..ad6f13c85c 100644
--- a/scene/3d/audio_listener_3d.cpp
+++ b/scene/3d/audio_listener_3d.cpp
@@ -88,6 +88,9 @@ void AudioListener3D::_notification(int p_what) {
case NOTIFICATION_TRANSFORM_CHANGED: {
_request_listener_update();
+ if (doppler_tracking != DOPPLER_TRACKING_DISABLED) {
+ velocity_tracker->update_position(get_global_transform().origin);
+ }
} break;
case NOTIFICATION_EXIT_WORLD: {
@@ -140,15 +143,50 @@ bool AudioListener3D::is_current() const {
}
}
+void AudioListener3D::set_doppler_tracking(DopplerTracking p_tracking) {
+ if (doppler_tracking == p_tracking) {
+ return;
+ }
+
+ doppler_tracking = p_tracking;
+ if (p_tracking != DOPPLER_TRACKING_DISABLED) {
+ velocity_tracker->set_track_physics_step(doppler_tracking == DOPPLER_TRACKING_PHYSICS_STEP);
+ if (is_inside_tree()) {
+ velocity_tracker->reset(get_global_transform().origin);
+ }
+ }
+}
+
+AudioListener3D::DopplerTracking AudioListener3D::get_doppler_tracking() const {
+ return doppler_tracking;
+}
+
void AudioListener3D::_bind_methods() {
ClassDB::bind_method(D_METHOD("make_current"), &AudioListener3D::make_current);
ClassDB::bind_method(D_METHOD("clear_current"), &AudioListener3D::clear_current);
ClassDB::bind_method(D_METHOD("is_current"), &AudioListener3D::is_current);
ClassDB::bind_method(D_METHOD("get_listener_transform"), &AudioListener3D::get_listener_transform);
+ ClassDB::bind_method(D_METHOD("set_doppler_tracking", "mode"), &AudioListener3D::set_doppler_tracking);
+ ClassDB::bind_method(D_METHOD("get_doppler_tracking"), &AudioListener3D::get_doppler_tracking);
+
+ ADD_PROPERTY(PropertyInfo(Variant::INT, "doppler_tracking", PROPERTY_HINT_ENUM, "Disabled,Idle,Physics"), "set_doppler_tracking", "get_doppler_tracking");
+
+ BIND_ENUM_CONSTANT(DOPPLER_TRACKING_DISABLED);
+ BIND_ENUM_CONSTANT(DOPPLER_TRACKING_IDLE_STEP);
+ BIND_ENUM_CONSTANT(DOPPLER_TRACKING_PHYSICS_STEP);
+}
+
+Vector3 AudioListener3D::get_doppler_tracked_velocity() const {
+ if (doppler_tracking != DOPPLER_TRACKING_DISABLED) {
+ return velocity_tracker->get_tracked_linear_velocity();
+ } else {
+ return Vector3();
+ }
}
AudioListener3D::AudioListener3D() {
set_notify_transform(true);
+ velocity_tracker.instantiate();
}
AudioListener3D::~AudioListener3D() {
diff --git a/scene/3d/audio_listener_3d.h b/scene/3d/audio_listener_3d.h
index 1c3c8ebc43..3c93ed5890 100644
--- a/scene/3d/audio_listener_3d.h
+++ b/scene/3d/audio_listener_3d.h
@@ -31,10 +31,32 @@
#pragma once
#include "scene/3d/node_3d.h"
+#include "scene/3d/velocity_tracker_3d.h"
class AudioListener3D : public Node3D {
GDCLASS(AudioListener3D, Node3D);
+public:
+ enum DopplerTracking {
+ DOPPLER_TRACKING_DISABLED,
+ DOPPLER_TRACKING_IDLE_STEP,
+ DOPPLER_TRACKING_PHYSICS_STEP,
+ };
+
+ void make_current();
+ void clear_current();
+ bool is_current() const;
+
+ virtual Transform3D get_listener_transform() const;
+
+ void set_doppler_tracking(DopplerTracking p_tracking);
+ DopplerTracking get_doppler_tracking() const;
+
+ Vector3 get_doppler_tracked_velocity() const;
+
+ AudioListener3D();
+ ~AudioListener3D();
+
private:
bool force_change = false;
bool current = false;
@@ -44,6 +66,9 @@ private:
friend class Viewport;
void _update_audio_listener_state();
+ DopplerTracking doppler_tracking = DOPPLER_TRACKING_DISABLED;
+ Ref velocity_tracker;
+
protected:
void _update_listener();
virtual void _request_listener_update();
@@ -54,14 +79,6 @@ protected:
void _notification(int p_what);
static void _bind_methods();
-
-public:
- void make_current();
- void clear_current();
- bool is_current() const;
-
- virtual Transform3D get_listener_transform() const;
-
- AudioListener3D();
- ~AudioListener3D();
};
+
+VARIANT_ENUM_CAST(AudioListener3D::DopplerTracking);
diff --git a/scene/3d/audio_stream_player_3d.cpp b/scene/3d/audio_stream_player_3d.cpp
index 1702e0609a..6a554c1c38 100644
--- a/scene/3d/audio_stream_player_3d.cpp
+++ b/scene/3d/audio_stream_player_3d.cpp
@@ -397,13 +397,11 @@ Vector AudioStreamPlayer3D::_update_panning() {
continue;
}
- bool listener_is_camera = true;
Node3D *listener_node = camera;
AudioListener3D *listener = vp->get_audio_listener_3d();
if (listener) {
listener_node = listener;
- listener_is_camera = false;
}
Vector3 local_pos = listener_node->get_global_transform().orthonormalized().affine_inverse().xform(global_pos);
@@ -507,7 +505,9 @@ Vector AudioStreamPlayer3D::_update_panning() {
if (doppler_tracking != DOPPLER_TRACKING_DISABLED) {
Vector3 listener_velocity;
- if (listener_is_camera) {
+ if (listener) {
+ listener_velocity = listener->get_doppler_tracked_velocity();
+ } else {
listener_velocity = camera->get_doppler_tracked_velocity();
}