Inherits: Node2D < CanvasItem < Node < Object

Overrides the location sounds are heard from.


Once added to the scene tree and enabled using make_current, this node will override the location sounds are heard from. Only one Listener2D can be current. Using make_current will disable the previous Listener2D.

If there is no active Listener2D in the current Viewport, center of the screen will be used as a hearing point for the audio. Listener2D needs to be inside SceneTree to function.



clear_current ( )


is_current ( ) const


make_current ( )

Method Descriptions

void clear_current ( )

Disables the Listener2D. If it's not set as current, this method will have no effect.

bool is_current ( ) const

Returns true if this Listener2D is currently active.

void make_current ( )

Makes the Listener2D active, setting it as the hearing point for the sounds. If there is already another active Listener2D, it will be disabled.

This method will have no effect if the Listener2D is not added to SceneTree.