Skip to content
Roblox API Reference

SoundService

A service that determines various aspects of how the audio engine works. Most of its properties affect how Sounds play in the experience.
  • Not creatable
  • Service
Memory category
Instances
Own members
54
Inherited members
75
Subclasses
0
Siblings
608

Properties40

Inherited fromObject2

Property categoryData

Inherited fromInstance21

Property categoryBehavior

Property categoryData

Property categoryPermissions

Defined bySoundService17

Property categoryData

  • SoundService.AcousticSimulationEnabled: boolean = false
    Determines whether acoustic simulation is enabled globally in the advanced audio system.
    • Capabilities: Audio
  • SoundService.AmbientReverb: Enum.ReverbType = Enum.ReverbType.NoReverb
    The ambient sound environment preset applied to all Sounds.
    • Capabilities: Audio
  • SoundService.AudioApiByDefault: Enum.RolloutState = Enum.RolloutState.Default
    • Hidden
    • Roblox script security
    • Read capabilities: Audio
  • SoundService.CharacterSoundsUseNewApi: Enum.RolloutState = Enum.RolloutState.Default
    Determines whether the default character sounds will use instances in the advanced audio system vs. Sounds.
    • Write: Plugin security
    • Read capabilities: Audio
  • SoundService.DiffractionEnabled: boolean = true
    • Capabilities: Audio
  • SoundService.DistanceFactor: number = 3.32999992
    The number of studs to be considered a meter by SoundService when simulating the Doppler effect for Sounds.
    • Capabilities: Audio
  • SoundService.DopplerScale: number = 1
    Degree to which the pitch of a Sound varies due to the Doppler effect.
    • Capabilities: Audio
  • SoundService.IsNewExpForAudioApiByDefault: boolean = false
    • Hidden
    • Roblox script security
    • Read capabilities: Audio
  • SoundService.OcclusionEnabled: boolean = true
    • Capabilities: Audio
  • SoundService.RespectFilteringEnabled: boolean = false
    Sets whether Sound playback from a client will replicate to the server.
    • Capabilities: Audio
  • SoundService.ReverbEnabled: boolean = true
    • Capabilities: Audio
  • SoundService.RolloffScale: number = 1
    Determines how fast the volume of a Sound attenuates beyond its Sound.RollOffMinDistance.
    • Capabilities: Audio
  • Determines whether certain spatialized Sounds emit volumetrically, throughout the space of their parent object.
    • Not scriptable
    • Capabilities: Audio

Property categoryListening

Methods69

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 bySoundService27
  • SoundService:BeginRecording(): boolean
    • Roblox script security
    • Capabilities: Audio
    Returns
    Type
    boolean
  • SoundService:DebugClearDetachedPlaybacks()
    • Roblox script security
    • Capabilities: Audio
  • SoundService:EnableDetachedPlaybackMetadata()
    • Roblox script security
    • Capabilities: Audio
  • SoundService:EndRecording(): { [string]: any }
    • Yields
    • Roblox script security
    • Capabilities: Audio
  • SoundService:GetAudioApiByDefault(): boolean
    • Roblox script security
    • Capabilities: Audio
    Returns
    Type
    boolean
  • SoundService:GetAudioInstances(): { any }
    • Roblox script security
    • Capabilities: Audio
    Returns
    Type
    { any }
  • SoundService:GetDetachedPlaybackData(): { [string]: any }
    • Roblox script security
    • Capabilities: Audio
  • SoundService:GetInputDevice(): ...any
    • Roblox script security
    • Capabilities: Audio
    Returns
    Type
    ...any
  • SoundService:GetInputDevices(): ...any
    • Roblox script security
    • Capabilities: Audio
    Returns
    Type
    ...any
  • SoundService:GetListener(): ...any
    Returns the current listener type used by Sounds, as well as what that listener is currently set to.
    • Capabilities: Audio
    Returns
    TypeDescription
    ...any
    A table containing two results. The first result is the listener's ListenerType and the second result is dependent on that type: Listener Type Description Enum.ListenerType.Camera Does not return a listener object as Class.Workspace.CurrentCamera|CurrentCamera is always used. Enum.ListenerType.CFrame Returns the Datatype.CFrame used in Class.SoundService:SetListener()|SetListener(). Enum.ListenerType.ObjectPosition Returns the Class.BasePart used in Class.SoundService:SetListener()|SetListener(). Enum.ListenerType.ObjectCFrame Returns the Class.BasePart used in Class.SoundService:SetListener()|SetListener().
  • SoundService:GetListenerWorldCFrame(): CFrame?
    • Roblox script security
    • Capabilities: Audio
    Returns
    Type
    CFrame?
  • SoundService:GetMixerTime(): number
    Returns the number of seconds since the audio engine began mixing.
    • Capabilities: Audio
    Returns
    TypeDescription
    number
    The number of seconds since the audio engine began mixing. This value is stable, sample-accurate, and monotonically-increasing. It's intended to be used for scheduling audible changes at precise times.
  • SoundService:GetOutputDevice(): ...any
    • Roblox script security
    • Capabilities: Audio
    Returns
    Type
    ...any
  • SoundService:GetOutputDevices(): ...any
    • Roblox script security
    • Capabilities: Audio
    Returns
    Type
    ...any
  • SoundService:GetPeakLevel(): number
    • Roblox script security
    • Capabilities: Audio
    Returns
    Type
    number
  • SoundService:GetRecordingDevices(): { [string]: any }
    • Yields
    • Roblox script security
    • Capabilities: Audio
  • SoundService:GetSoundMemoryData(): { [string]: any }
    • Roblox script security
    • Capabilities: Audio
  • SoundService:InsertAsset(assetId: string,assetName: string,useSelection: boolean? = true,): { Instance }
    • Roblox script security
    • Capabilities: Audio
    Parameters
    Parameter
    assetId: string
    assetName: string
    useSelection: boolean? = true
    Returns
    Type
    { Instance }
  • SoundService:OpenAttenuationCurveEditor(selectedCurveObjects: { Instance })
    Opens the attenuation curve editor in Studio for the provided AudioEmitter or AudioListener instances.
    • Plugin security
    • Capabilities: Audio
    Parameters
    ParameterDescription
    selectedCurveObjects: { Instance }
    A list of AudioEmitters or AudioListeners.
  • SoundService:OpenDirectionalCurveEditor(selectedCurveObjects: { Instance })
    Opens the directional curve editor in Studio for the provided AudioEmitter or AudioListener instances.
    • Plugin security
    • Capabilities: Audio
    Parameters
    ParameterDescription
    selectedCurveObjects: { Instance }
    A list of AudioEmitters or AudioListeners.
  • SoundService:PlayLocalSound(sound: Instance)
    Plays a copy of a Sound locally, such that it will only be heard by the client calling this method.
    • Capabilities: Audio
    Parameters
    ParameterDescription
    sound: Instance
    The Sound to be played.
  • SoundService:SetAudioApiByDefault(enabled: boolean)
    • Roblox script security
    • Capabilities: Audio
    Parameters
    Parameter
    enabled: boolean
  • SoundService:SetInputDevice(nameOrInstance: any, guidOrPin: string)
    • Capabilities: Audio + InternalTest
    Parameters
    Parameter
    nameOrInstance: any
    guidOrPin: string
  • SoundService:SetListener(listenerType: Enum.ListenerType, ...: any)
    Sets the listener used by Sounds.
    • Capabilities: Audio
    Parameters
    ParameterDescription
    listenerType: Enum.ListenerType
    The ListenerType of the listener.
    ...: any
    Dependent on the ListenerType. Use a BasePart for ListenerType.ObjectPosition or ListenerType.ObjectCFrame, a CFrame for ListenerType.CFrame, or nil for ListenerType.Camera.
  • SoundService:SetOutputDevice(name: string, guid: string)
    • Roblox script security
    • Capabilities: Audio
    Parameters
    Parameter
    name: string
    guid: string
  • SoundService:SetRecordingDevice(deviceIndex: number): boolean
    • Roblox script security
    • Capabilities: Audio
    Parameters
    Parameter
    deviceIndex: number
    Returns
    Type
    boolean
  • SoundService:SetSoundEnabled(enabled: boolean)
    • Roblox script security
    • Capabilities: Audio
    Parameters
    Parameter
    enabled: boolean

Events20

Inherited fromObject1
Inherited fromInstance9
Defined bySoundService10