Work in progress

Godot documentation is being updated to reflect the latest changes in version 4.0. Some documentation pages may still state outdated information. This banner will tell you if you're reading one of such pages.

The contents of this page are up to date. If you can still find outdated information, please open an issue.

AudioListener3D

Inherits: Node3D < Node < Object

Overrides the location sounds are heard from.

Description

Once added to the scene tree and enabled using make_current, this node will override the location sounds are heard from. This can be used to listen from a location different from the Camera3D.

Methods

void	clear_current ( )
Transform3D	get_listener_transform ( ) const
bool	is_current ( ) const
void	make_current ( )

---

Method Descriptions

void clear_current ( )

Disables the listener to use the current camera's listener instead.

---

Transform3D get_listener_transform ( ) const

Returns the listener's global orthonormalized Transform3D.

---

bool is_current ( ) const

Returns true if the listener was made current using make_current, false otherwise.

Note: There may be more than one AudioListener3D marked as "current" in the scene tree, but only the one that was made current last will be used.

---

void make_current ( )

Enables the listener. This will override the current camera's listener.