Skip to content
Roblox API Reference

AudioListener

Records an audio stream from its surrounding AudioEmitters in the 3D world.
Memory category
Internal
Own members
22
Inherited members
75
Subclasses
0
Siblings
608

Properties33

Inherited fromObject2

Property categoryData

Inherited fromInstance21

Property categoryBehavior

Property categoryData

Property categoryPermissions

Defined byAudioListener10

Property categoryInteractions

  • AudioListener.AudioInteractionGroup: string = ""
    Controls which AudioEmitters are audible to this AudioListener.
    • Read capabilities: Audio

Property categoryListening

  • AudioListener.AngleAttenuation: string = ""
    Represents how the perceived volume of the emitted sound changes based on the angle between a AudioEmitter and the LookVector associated with the AudioListener.
    • Roblox engine security
    • Read capabilities: Audio
  • AudioListener.DistanceAttenuation: string = ""
    Represents how the perceived volume of emitted sounds change as the distance between AudioEmitters and the AudioListener increases.
    • Roblox engine security
    • Read capabilities: Audio
  • AudioListener.PositionInstance: Instance
    The Instance whose position and orientation is used as the listener's position if PositionType is set to ListenerPositionType.Instance.
    • Capabilities: Audio
  • Determines how the AudioListener determines its 3D location.
    • Capabilities: Audio

Property categorySimulation

Methods53

Inherited fromObject3
  • Get an event that fires when a given property of the object changes.
    Parameters
    ParameterDescription
    property: string
    The property to connect to.
    Returns
    TypeDescription
    RBXScriptSignal
    A signal that fires whenever the property changes.
  • Object:IsA(className: string): boolean
    Returns true if an object's class matches or inherits from a given class.
    • Custom Lua state
    • Thread safe
    Parameters
    ParameterDescription
    className: string
    The class against which the Object's class will be checked. Case-sensitive.
    Returns
    TypeDescription
    boolean
    Describes whether the Object's class matched or is a subclass of the given class.
  • Object:isA(className: string): boolean
    Deprecated: This deprecated function is a variant of Object:IsA() which should be used instead.
    • Deprecated
    • Custom Lua state
    Parameters
    Parameter
    className: string
    Returns
    Type
    boolean

    Use IsA instead.

Inherited fromInstance39
Defined byAudioListener11
  • AudioListener:GetAngleAttenuation(): { [string]: any }
    Gets the angle attenuation curve that the AudioListener is using, or an empty table if it's using the default curve.
    • Custom Lua state
    • Capabilities: Audio
    Returns
    TypeDescription
    { [string]: any }
    Table mapping angle to volume, as described above.
  • AudioListener:GetAudibilityFor(emitter: AudioEmitter): number
    Calculates how audible an AudioEmitter is for this listener
    • Capabilities: Audio
    Parameters
    ParameterDescription
    emitter: AudioEmitter
    The AudioEmitter whose audibility should be calculated relative to this listener.
    Returns
    TypeDescription
    number
    A number between 0 and 1 representing the combined volume after distance and angle attenuation from both the emitter and listener.
  • AudioListener:GetConnectedWires(pin: string): { Instance }
    Returns an array of Wires that are connected to the specified pin.
    • Capabilities: Audio
    Parameters
    ParameterDescription
    pin: string
    An input or output pin on this instance
    Returns
    TypeDescription
    { Instance }
    An array of Wires
  • AudioListener:GetDistanceAttenuation(): { [string]: any }
    Gets the distance attenuation curve that the AudioListener is using, or an empty table if it's using the default curve.
    • Custom Lua state
    • Capabilities: Audio
    Returns
    TypeDescription
    { [string]: any }
    A table mapping distance keys to volume values, or an empty table if the default curve is being used.
  • AudioListener:GetInputPins(): { any }
    Gets the list of pins that Wire can use in Wire.TargetName to connect to this instance via its Wire.TargetInstance property.
    • Capabilities: Audio
    Returns
    TypeDescription
    { any }
    An array of strings representing valid pin names.
  • AudioListener:GetInteractingEmitters(): { Instance }
    Lists all AudioEmitters that this listener is capable of hearing.
    • Capabilities: Audio
    Returns
    TypeDescription
    { Instance }
    An array of AudioEmitters that share an AudioInteractionGroup with this listener.
  • AudioListener:GetOutputPins(): { any }
    Gets the list of pins that Wire can use in Wire.SourceName to connect to this instance via its Wire.SourceInstance property.
    • Capabilities: Audio
    Returns
    TypeDescription
    { any }
    An array of strings representing valid pin names.
  • AudioListener:GetWorldCFrame(): CFrame?
    • Roblox script security
    • Capabilities: Audio
    Returns
    Type
    CFrame?
  • AudioListener:Reset()
    • Roblox script security
    • Capabilities: Audio
  • AudioListener:SetAngleAttenuation(curve: { [string]: any })
    Sets the angle attenuation curve that the AudioListener should use, or uses a constant curve of volume 1 if none is provided.
    • Custom Lua state
    • Capabilities: Audio
    Parameters
    ParameterDescription
    curve: { [string]: any }
    A table mapping angle keys (0 to 180) to volume values (0 to 1), or an empty/nil table to use the default constant volume of 1.
  • AudioListener:SetDistanceAttenuation(curve: { [string]: any })
    Sets the distance attenuation curve that the AudioListener should use, or uses an inverse rolloff curve if none is provided.
    • Custom Lua state
    • Capabilities: Audio
    Parameters
    ParameterDescription
    curve: { [string]: any }
    A table mapping distance keys (greater than or equal to 0) to volume values (0 to 1), or an empty/nil table to use the default constant volume of 1 everywhere.

Events11

Inherited fromObject1
Inherited fromInstance9
Defined byAudioListener1