Learn
Engine Class
SoundService
Not Creatable
Service

Code Samples
Dynamic Reverb System
local Players = game:GetService("Players")
local CollectionService = game:GetService("CollectionService")
local SoundService = game:GetService("SoundService")
local localPlayer = Players.LocalPlayer
local reverbTags = {
["reverb_Cave"] = Enum.ReverbType.Cave,
}
-- collect parts and group them by tag
local parts = {}
for reverbTag, reverbType in pairs(reverbTags) do
for _, part in pairs(CollectionService:GetTagged(reverbTag)) do
parts[part] = reverbType
end
end
-- function to check if a position is within a part's extents
local function positionInPart(part, position)
local extents = part.Size / 2
local offset = part.CFrame:PointToObjectSpace(position)
return offset.x < extents.x and offset.y < extents.y and offset.z < extents.z
end
local reverbType = SoundService.AmbientReverb
while true do
task.wait()
if not localPlayer then
return
end
local character = localPlayer.Character
-- default to no reverb
local newReverbType = Enum.ReverbType.NoReverb
if character and character.PrimaryPart then
local position = character.PrimaryPart.Position
-- go through all the indexed parts
for part, type in pairs(parts) do
-- see if the character is within them
if positionInPart(part, position) then
-- if so, pick that reverb type
newReverbType = type
break
end
end
end
-- set the reverb type if it has changed
if newReverbType ~= reverbType then
SoundService.AmbientReverb = newReverbType
reverbType = newReverbType
end
end

API Reference
Properties
AcousticSimulationEnabled
Read Parallel
Capabilities: Audio
SoundService.AcousticSimulationEnabled:boolean

AmbientReverb
Read Parallel
Capabilities: Audio
SoundService.AmbientReverb:Enum.ReverbType

CharacterSoundsUseNewApi
Plugin Security
Read Parallel
Capabilities: Audio
SoundService.CharacterSoundsUseNewApi:Enum.RolloutState

DefaultListenerLocation
Plugin Security
Read Parallel
Capabilities: Audio
SoundService.DefaultListenerLocation:Enum.ListenerLocation

DistanceFactor
Read Parallel
Capabilities: Audio
SoundService.DistanceFactor:number

DopplerScale
Read Parallel
Capabilities: Audio
SoundService.DopplerScale:number

ListenerCFrame
Read Parallel
Capabilities: Audio
SoundService.ListenerCFrame:CFrame

ListenerObject
Read Parallel
Capabilities: Audio
SoundService.ListenerObject:Instance

ListenerType
Read Parallel
Capabilities: Audio
SoundService.ListenerType:Enum.ListenerType

RespectFilteringEnabled
Read Parallel
Capabilities: Audio
SoundService.RespectFilteringEnabled:boolean

RolloffScale
Read Parallel
Capabilities: Audio
SoundService.RolloffScale:number

VolumetricAudio
Not Scriptable
Read Parallel
Capabilities: Audio
SoundService.VolumetricAudio:Enum.VolumetricAudio

Methods
GetListener
Capabilities: Audio
SoundService:GetListener():Tuple
Returns

GetMixerTime
Capabilities: Audio
SoundService:GetMixerTime():number
Returns

OpenAttenuationCurveEditor
Plugin Security
Capabilities: Audio
SoundService:OpenAttenuationCurveEditor(selectedCurveObjects:Instances):()
Parameters
selectedCurveObjects:Instances
Returns
()

OpenDirectionalCurveEditor
Plugin Security
Capabilities: Audio
SoundService:OpenDirectionalCurveEditor(selectedCurveObjects:Instances):()
Parameters
selectedCurveObjects:Instances
Returns
()

PlayLocalSound
Capabilities: Audio
SoundService:PlayLocalSound(sound:Instance):()
Parameters
sound:Instance
Returns
()

SetListener
Capabilities: Audio
SoundService:SetListener(
listenerType:Enum.ListenerType, listener:Tuple
):()
Parameters
listenerType:Enum.ListenerType
listener:Tuple
Returns
()

©2026 Roblox Corporation. Roblox, the Roblox logo and Powering Imagination are among our registered and unregistered trademarks in the U.S. and other countries.