Meer informatie
Engine-klasse
Sound

*Deze inhoud is vertaald met behulp van AI (bèta) en kan fouten bevatten. Klik hier om deze pagina in het Engels te bekijken.


Codevoorbeelden
Muziek Speelonderdeel
local part = Instance.new("Part")
part.Anchored = true
part.Position = Vector3.new(0, 3, 0)
part.BrickColor = BrickColor.new("Heldere rood")
part.Name = "Muziekdoos"
part.Parent = workspace
-- maak een geluid aan
local sound = Instance.new("Sound", part)
sound.SoundId = "rbxassetid://9120386436"
sound.EmitterSize = 5 -- verklein de emittergrootte (voor eerder volumeverlies)
sound.Looped = true
sound.Parent = part
local clickDetector = Instance.new("ClickDetector")
clickDetector.Parent = part
-- schakel het geluid aan / uit
clickDetector.MouseClick:Connect(function()
if not sound.IsPlaying then
part.BrickColor = BrickColor.new("Heldere groen")
sound:Play()
else
part.BrickColor = BrickColor.new("Heldere rood")
sound:Stop()
end
end)

API-referentie
Eigenschappen
AudioContent
Parallel lezen
Mogelijkheden: LegacySound
Sound.AudioContent:Content

EmitterSize
Verouderd

IsLoaded
Alleen-lezen
Niet gerepliceerd
Parallel lezen
Mogelijkheden: LegacySound
Sound.IsLoaded:boolean
Codevoorbeelden
Geluid Laden
local sound = script.Parent.Sound
if not sound.IsLoaded then
sound.Loaded:Wait()
end
print("Het geluid is geladen!")

IsPaused
Verborgen
Alleen-lezen
Niet gerepliceerd
Parallel lezen
Mogelijkheden: LegacySound
Sound.IsPaused:boolean
Codevoorbeelden
Geluid IsPlaying en GeluidIsPaused
local sound = Instance.new("Sound")
sound.SoundId = "rbxassetid://9120386436"
sound.Looped = true
sound.Parent = workspace
if not sound.isLoaded then
sound.Loaded:Wait()
end
sound:Play()
print(sound.IsPlaying, sound.IsPaused) -- waar, onwaar
task.wait(2)
sound:Pause()
print(sound.IsPlaying, sound.IsPaused) -- onwaar, waar
task.wait(2)
sound:Play()
print(sound.IsPlaying, sound.IsPaused) -- waar, onwaar
task.wait(2)
sound:Stop()
print(sound.IsPlaying, sound.IsPaused) -- onwaar, waar

IsPlaying
Verborgen
Alleen-lezen
Niet gerepliceerd
Parallel lezen
Mogelijkheden: LegacySound
Sound.IsPlaying:boolean
Codevoorbeelden
Geluid IsPlaying en GeluidIsPaused
local sound = Instance.new("Sound")
sound.SoundId = "rbxassetid://9120386436"
sound.Looped = true
sound.Parent = workspace
if not sound.isLoaded then
sound.Loaded:Wait()
end
sound:Play()
print(sound.IsPlaying, sound.IsPaused) -- waar, onwaar
task.wait(2)
sound:Pause()
print(sound.IsPlaying, sound.IsPaused) -- onwaar, waar
task.wait(2)
sound:Play()
print(sound.IsPlaying, sound.IsPaused) -- waar, onwaar
task.wait(2)
sound:Stop()
print(sound.IsPlaying, sound.IsPaused) -- onwaar, waar

isPlaying
Verouderd

Looped
Parallel lezen
Mogelijkheden: LegacySound
Sound.Looped:boolean
Codevoorbeelden
Herhalen van een Aantal Keer
local function loopNTimes(sound, numberOfLoops)
if not sound.IsPlaying then
sound.Looped = true
local connection = nil
connection = sound.DidLoop:Connect(function(_soundId, numOfTimesLooped)
print(numOfTimesLooped)
if numOfTimesLooped >= numberOfLoops then
-- verbreek de verbinding
connection:Disconnect()
-- stop het geluid
sound:Stop()
end
end)
sound:Play()
end
end
local sound = Instance.new("Sound")
sound.SoundId = "rbxassetid://0"
loopNTimes(sound, 5)

LoopRegion
Parallel lezen
Mogelijkheden: LegacySound
Sound.LoopRegion:NumberRange

MaxDistance
Verouderd

MinDistance
Verouderd

Pitch
Verouderd

PlaybackLoudness
Alleen-lezen
Niet gerepliceerd
Parallel lezen
Mogelijkheden: LegacySound
Sound.PlaybackLoudness:number
Codevoorbeelden
Volume Amplitude Bar
-- moet worden geplaatst in StarterPlayer > StarterPlayerScripts
local Players = game:GetService("Players")
-- wacht op lokale speler PlayerGui
local LocalPlayer = Players.LocalPlayer
local playerGui = LocalPlayer:WaitForChild("PlayerGui")
-- maak een ScreenGui
local screenGui = Instance.new("ScreenGui")
screenGui.Parent = playerGui
-- maak een houder voor onze balk
local frame = Instance.new("Frame")
frame.AnchorPoint = Vector2.new(0.5, 0.5)
frame.Position = UDim2.new(0.5, 0, 0.5, 0)
frame.Size = UDim2.new(0.3, 0, 0.05, 0)
frame.Parent = screenGui
-- maak een balk
local bar = Instance.new("Frame")
bar.Position = UDim2.new(0, 0, 0, 0)
bar.Size = UDim2.new(1, 0, 1, 0)
bar.BackgroundColor3 = Color3.new(0, 1, 0)
bar.Parent = frame
-- maak een geluid
local sound = Instance.new("Sound")
sound.SoundId = "rbxassetid://9120386436"
sound.Looped = true
sound.Parent = screenGui
sound:Play()
-- definieer een maximale luidheid
local maxLoudness = 30
-- animeer de amplitudebalk
while true do
local amplitude = math.clamp(sound.PlaybackLoudness / maxLoudness, 0, 1)
bar.Size = UDim2.new(amplitude, 0, 1, 0)
wait(0.05)
end

PlaybackRegion
Parallel lezen
Mogelijkheden: LegacySound
Sound.PlaybackRegion:NumberRange

PlaybackRegionsEnabled
Parallel lezen
Mogelijkheden: LegacySound
Sound.PlaybackRegionsEnabled:boolean

PlaybackSpeed
Niet gerepliceerd
Parallel lezen
Mogelijkheden: LegacySound
Sound.PlaybackSpeed:number
Codevoorbeelden
Geluid Afspeelsnelheid
local sound = Instance.new("Sound")
sound.SoundId = "rbxassetid://9120386436"
sound.Looped = true
sound.Parent = workspace
sound:Play()
task.wait(10)
sound.PlaybackSpeed = 3 -- 3x sneller
task.wait(5)
sound.PlaybackSpeed = 0.5 -- 2x langzamer
task.wait(5)
sound.PlaybackSpeed = 1 -- standaard

Playing
Niet gerepliceerd
Parallel lezen
Mogelijkheden: LegacySound
Sound.Playing:boolean
Codevoorbeelden
Geluid Afspelen
local sound = Instance.new("Sound")
sound.SoundId = "rbxassetid://9120386436"
sound.Looped = true
sound.Parent = workspace
print("geluid aan het afspelen")
sound.Playing = true
task.wait(10)
print("geluid stoppen")
sound.Playing = false
task.wait(5)
sound.Playing = true
local timePosition = sound.TimePosition
print("hervat op tijdspositie: " .. tostring(timePosition)) -- c. 10 seconden

PlayOnRemove
Parallel lezen
Mogelijkheden: LegacySound
Sound.PlayOnRemove:boolean

RollOffMaxDistance
Parallel lezen
Mogelijkheden: LegacySound
Sound.RollOffMaxDistance:number

RollOffMinDistance
Parallel lezen
Mogelijkheden: LegacySound
Sound.RollOffMinDistance:number

RollOffMode
Parallel lezen
Mogelijkheden: LegacySound
Sound.RollOffMode:Enum.RollOffMode

SoundGroup
Parallel lezen
Mogelijkheden: LegacySound
Sound.SoundGroup:SoundGroup

SoundId
Parallel lezen
Mogelijkheden: LegacySound
Sound.SoundId:ContentId

TimeLength
Alleen-lezen
Niet gerepliceerd
Parallel lezen
Mogelijkheden: LegacySound
Sound.TimeLength:number
Codevoorbeelden
Speel een Geluid voor een Bepaalde Duur
local function playForDuration(sound, duration)
if not sound.IsLoaded then
sound.Loaded:wait()
end
local speed = sound.TimeLength / duration
sound.PlaybackSpeed = speed
sound:Play()
end
local sound = script.Parent
playForDuration(sound, 5)

TimePosition
Niet gerepliceerd
Parallel lezen
Mogelijkheden: LegacySound
Sound.TimePosition:number
Codevoorbeelden
Geluid Tijdpositie
local sound = Instance.new("Sound")
sound.SoundId = "rbxassetid://9120386436"
sound.Parent = workspace
sound.TimePosition = 30
sound:Play()
task.wait(5)
sound.TimePosition = 100
task.wait(5)
sound.TimePosition = 0
Tijdpositie
local Workspace = game:GetService("Workspace")
local sound = Instance.new("Sound")
sound.Parent = Workspace
local newPosition = 1.5
if newPosition >= sound.TimeLength then
newPosition = newPosition - sound.TimeLength
end
sound.TimePosition = newPosition

Volume
Parallel lezen
Mogelijkheden: LegacySound
Sound.Volume:number

Methoden
Pause
Mogelijkheden: LegacySound
Sound:Pause():()
Teruggaves
()
Codevoorbeelden
Geluid Functies
-- maak een geluid
local sound = Instance.new("Sound", game.Workspace)
sound.SoundId = "rbxassetid://9120386436"
if not sound.IsLoaded then
sound.Loaded:Wait()
end
-- luister naar gebeurtenissen
sound.Played:Connect(function(_soundId)
print("Geluid.Played gebeurtenis")
end)
sound.Paused:Connect(function(_soundId)
print("Geluid.Paused gebeurtenis")
end)
sound.Resumed:Connect(function(_soundId)
print("Geluid.Resumed gebeurtenis")
end)
sound.Stopped:Connect(function(_soundId)
print("Geluid.Stopped gebeurtenis")
end)
sound:Play()
print("speel", sound.Playing, sound.TimePosition) -- speel true 0
task.wait(10)
sound:Pause()
print("pauze", sound.Playing, sound.TimePosition) -- pauze false 10
task.wait(3)
sound:Resume()
print("speel", sound.Playing, sound.TimePosition) -- speel true 10
task.wait(3)
sound:Stop()
print("stop", sound.Playing, sound.TimePosition) -- stop false 0
task.wait(3)
sound:Play()
print("speel", sound.Playing, sound.TimePosition) -- speel true 0

pause
Verouderd

Play
Mogelijkheden: LegacySound
Sound:Play():()
Teruggaves
()
Codevoorbeelden
Geluid Functies
-- maak een geluid
local sound = Instance.new("Sound", game.Workspace)
sound.SoundId = "rbxassetid://9120386436"
if not sound.IsLoaded then
sound.Loaded:Wait()
end
-- luister naar gebeurtenissen
sound.Played:Connect(function(_soundId)
print("Geluid.Played gebeurtenis")
end)
sound.Paused:Connect(function(_soundId)
print("Geluid.Paused gebeurtenis")
end)
sound.Resumed:Connect(function(_soundId)
print("Geluid.Resumed gebeurtenis")
end)
sound.Stopped:Connect(function(_soundId)
print("Geluid.Stopped gebeurtenis")
end)
sound:Play()
print("speel", sound.Playing, sound.TimePosition) -- speel true 0
task.wait(10)
sound:Pause()
print("pauze", sound.Playing, sound.TimePosition) -- pauze false 10
task.wait(3)
sound:Resume()
print("speel", sound.Playing, sound.TimePosition) -- speel true 10
task.wait(3)
sound:Stop()
print("stop", sound.Playing, sound.TimePosition) -- stop false 0
task.wait(3)
sound:Play()
print("speel", sound.Playing, sound.TimePosition) -- speel true 0

play
Verouderd

Resume
Mogelijkheden: LegacySound
Sound:Resume():()
Teruggaves
()
Codevoorbeelden
Geluid Functies
-- maak een geluid
local sound = Instance.new("Sound", game.Workspace)
sound.SoundId = "rbxassetid://9120386436"
if not sound.IsLoaded then
sound.Loaded:Wait()
end
-- luister naar gebeurtenissen
sound.Played:Connect(function(_soundId)
print("Geluid.Played gebeurtenis")
end)
sound.Paused:Connect(function(_soundId)
print("Geluid.Paused gebeurtenis")
end)
sound.Resumed:Connect(function(_soundId)
print("Geluid.Resumed gebeurtenis")
end)
sound.Stopped:Connect(function(_soundId)
print("Geluid.Stopped gebeurtenis")
end)
sound:Play()
print("speel", sound.Playing, sound.TimePosition) -- speel true 0
task.wait(10)
sound:Pause()
print("pauze", sound.Playing, sound.TimePosition) -- pauze false 10
task.wait(3)
sound:Resume()
print("speel", sound.Playing, sound.TimePosition) -- speel true 10
task.wait(3)
sound:Stop()
print("stop", sound.Playing, sound.TimePosition) -- stop false 0
task.wait(3)
sound:Play()
print("speel", sound.Playing, sound.TimePosition) -- speel true 0

Stop
Mogelijkheden: LegacySound
Sound:Stop():()
Teruggaves
()
Codevoorbeelden
Geluid Functies
-- maak een geluid
local sound = Instance.new("Sound", game.Workspace)
sound.SoundId = "rbxassetid://9120386436"
if not sound.IsLoaded then
sound.Loaded:Wait()
end
-- luister naar gebeurtenissen
sound.Played:Connect(function(_soundId)
print("Geluid.Played gebeurtenis")
end)
sound.Paused:Connect(function(_soundId)
print("Geluid.Paused gebeurtenis")
end)
sound.Resumed:Connect(function(_soundId)
print("Geluid.Resumed gebeurtenis")
end)
sound.Stopped:Connect(function(_soundId)
print("Geluid.Stopped gebeurtenis")
end)
sound:Play()
print("speel", sound.Playing, sound.TimePosition) -- speel true 0
task.wait(10)
sound:Pause()
print("pauze", sound.Playing, sound.TimePosition) -- pauze false 10
task.wait(3)
sound:Resume()
print("speel", sound.Playing, sound.TimePosition) -- speel true 10
task.wait(3)
sound:Stop()
print("stop", sound.Playing, sound.TimePosition) -- stop false 0
task.wait(3)
sound:Play()
print("speel", sound.Playing, sound.TimePosition) -- speel true 0

stop
Verouderd

Evenementen
DidLoop
Mogelijkheden: LegacySound
Sound.DidLoop(
soundId:string, numOfTimesLooped:number
Parameters
soundId:string
numOfTimesLooped:number
Codevoorbeelden
Herhalen van een Aantal Keer
local function loopNTimes(sound, numberOfLoops)
if not sound.IsPlaying then
sound.Looped = true
local connection = nil
connection = sound.DidLoop:Connect(function(_soundId, numOfTimesLooped)
print(numOfTimesLooped)
if numOfTimesLooped >= numberOfLoops then
-- verbreek de verbinding
connection:Disconnect()
-- stop het geluid
sound:Stop()
end
end)
sound:Play()
end
end
local sound = Instance.new("Sound")
sound.SoundId = "rbxassetid://0"
loopNTimes(sound, 5)

Ended
Mogelijkheden: LegacySound
Sound.Ended(soundId:string):RBXScriptSignal
Parameters
soundId:string

Loaded
Mogelijkheden: LegacySound
Sound.Loaded(soundId:string):RBXScriptSignal
Parameters
soundId:string
Codevoorbeelden
Geluid Laden
local sound = script.Parent.Sound
if not sound.IsLoaded then
sound.Loaded:Wait()
end
print("Het geluid is geladen!")

Paused
Mogelijkheden: LegacySound
Sound.Paused(soundId:string):RBXScriptSignal
Parameters
soundId:string
Codevoorbeelden
Geluid Functies
-- maak een geluid
local sound = Instance.new("Sound", game.Workspace)
sound.SoundId = "rbxassetid://9120386436"
if not sound.IsLoaded then
sound.Loaded:Wait()
end
-- luister naar gebeurtenissen
sound.Played:Connect(function(_soundId)
print("Geluid.Played gebeurtenis")
end)
sound.Paused:Connect(function(_soundId)
print("Geluid.Paused gebeurtenis")
end)
sound.Resumed:Connect(function(_soundId)
print("Geluid.Resumed gebeurtenis")
end)
sound.Stopped:Connect(function(_soundId)
print("Geluid.Stopped gebeurtenis")
end)
sound:Play()
print("speel", sound.Playing, sound.TimePosition) -- speel true 0
task.wait(10)
sound:Pause()
print("pauze", sound.Playing, sound.TimePosition) -- pauze false 10
task.wait(3)
sound:Resume()
print("speel", sound.Playing, sound.TimePosition) -- speel true 10
task.wait(3)
sound:Stop()
print("stop", sound.Playing, sound.TimePosition) -- stop false 0
task.wait(3)
sound:Play()
print("speel", sound.Playing, sound.TimePosition) -- speel true 0

Played
Mogelijkheden: LegacySound
Sound.Played(soundId:string):RBXScriptSignal
Parameters
soundId:string
Codevoorbeelden
Geluid Functies
-- maak een geluid
local sound = Instance.new("Sound", game.Workspace)
sound.SoundId = "rbxassetid://9120386436"
if not sound.IsLoaded then
sound.Loaded:Wait()
end
-- luister naar gebeurtenissen
sound.Played:Connect(function(_soundId)
print("Geluid.Played gebeurtenis")
end)
sound.Paused:Connect(function(_soundId)
print("Geluid.Paused gebeurtenis")
end)
sound.Resumed:Connect(function(_soundId)
print("Geluid.Resumed gebeurtenis")
end)
sound.Stopped:Connect(function(_soundId)
print("Geluid.Stopped gebeurtenis")
end)
sound:Play()
print("speel", sound.Playing, sound.TimePosition) -- speel true 0
task.wait(10)
sound:Pause()
print("pauze", sound.Playing, sound.TimePosition) -- pauze false 10
task.wait(3)
sound:Resume()
print("speel", sound.Playing, sound.TimePosition) -- speel true 10
task.wait(3)
sound:Stop()
print("stop", sound.Playing, sound.TimePosition) -- stop false 0
task.wait(3)
sound:Play()
print("speel", sound.Playing, sound.TimePosition) -- speel true 0

Resumed
Mogelijkheden: LegacySound
Sound.Resumed(soundId:string):RBXScriptSignal
Parameters
soundId:string
Codevoorbeelden
Geluid Functies
-- maak een geluid
local sound = Instance.new("Sound", game.Workspace)
sound.SoundId = "rbxassetid://9120386436"
if not sound.IsLoaded then
sound.Loaded:Wait()
end
-- luister naar gebeurtenissen
sound.Played:Connect(function(_soundId)
print("Geluid.Played gebeurtenis")
end)
sound.Paused:Connect(function(_soundId)
print("Geluid.Paused gebeurtenis")
end)
sound.Resumed:Connect(function(_soundId)
print("Geluid.Resumed gebeurtenis")
end)
sound.Stopped:Connect(function(_soundId)
print("Geluid.Stopped gebeurtenis")
end)
sound:Play()
print("speel", sound.Playing, sound.TimePosition) -- speel true 0
task.wait(10)
sound:Pause()
print("pauze", sound.Playing, sound.TimePosition) -- pauze false 10
task.wait(3)
sound:Resume()
print("speel", sound.Playing, sound.TimePosition) -- speel true 10
task.wait(3)
sound:Stop()
print("stop", sound.Playing, sound.TimePosition) -- stop false 0
task.wait(3)
sound:Play()
print("speel", sound.Playing, sound.TimePosition) -- speel true 0

Stopped
Mogelijkheden: LegacySound
Sound.Stopped(soundId:string):RBXScriptSignal
Parameters
soundId:string
Codevoorbeelden
Geluid Functies
-- maak een geluid
local sound = Instance.new("Sound", game.Workspace)
sound.SoundId = "rbxassetid://9120386436"
if not sound.IsLoaded then
sound.Loaded:Wait()
end
-- luister naar gebeurtenissen
sound.Played:Connect(function(_soundId)
print("Geluid.Played gebeurtenis")
end)
sound.Paused:Connect(function(_soundId)
print("Geluid.Paused gebeurtenis")
end)
sound.Resumed:Connect(function(_soundId)
print("Geluid.Resumed gebeurtenis")
end)
sound.Stopped:Connect(function(_soundId)
print("Geluid.Stopped gebeurtenis")
end)
sound:Play()
print("speel", sound.Playing, sound.TimePosition) -- speel true 0
task.wait(10)
sound:Pause()
print("pauze", sound.Playing, sound.TimePosition) -- pauze false 10
task.wait(3)
sound:Resume()
print("speel", sound.Playing, sound.TimePosition) -- speel true 10
task.wait(3)
sound:Stop()
print("stop", sound.Playing, sound.TimePosition) -- stop false 0
task.wait(3)
sound:Play()
print("speel", sound.Playing, sound.TimePosition) -- speel true 0

©2026 Roblox Corporation. Roblox, het Roblox-logo en Powering Imagination behoren tot onze geregistreerde en niet-geregistreerde handelsmerken in de VS en andere landen.