diff --git a/doc/classes/AudioListener3D.xml b/doc/classes/AudioListener3D.xml
index c9de0891953..b764b9aae53 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 718f0e149c5..51e5f6c52c9 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 b24cdfd462e..d7ef4320ce0 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 4a18447b3bd..ad6f13c85cf 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 1c3c8ebc431..3c93ed58905 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 1702e0609af..6a554c1c38d 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();
}