Creador(a)
​
API del motor
Notas de la versión
Aprender
Clase de motor
Sound

*Este contenido se traduce usando la IA (Beta) y puede contener errores. Para ver esta página en inglés, haz clic en aquí.

Resumen
Métodos
Pause():()
pause():()
Obsoleto
Play():()
play():()
Obsoleto
Resume():()
Stop():()
stop():()
Obsoleto
Miembros heredados
Muestras de código
Parte de Música Reproduciendo
local part = Instance.new("Part")

part.Anchored = true

part.Position = Vector3.new(0, 3, 0)

part.BrickColor = BrickColor.new("Bright red")

part.Name = "MusicBox"

part.Parent = workspace



-- crear un sonido

local sound = Instance.new("Sound", part)

sound.SoundId = "rbxassetid://9120386436"

sound.EmitterSize = 5 -- disminuir el tamaño del emisor (para una caída de volumen más temprana)

sound.Looped = true

sound.Parent = part



local clickDetector = Instance.new("ClickDetector")

clickDetector.Parent = part



-- alternar la reproducción del sonido / no reproducido

clickDetector.MouseClick:Connect(function()

	if not sound.IsPlaying then

		part.BrickColor = BrickColor.new("Bright green")

		sound:Play()

	else

		part.BrickColor = BrickColor.new("Bright red")

		sound:Stop()

	end

end)
Referencia API
Propiedades
AcousticSimulationEnabled
Leer paralelo
Capacidades: LegacySound
Sound.AcousticSimulationEnabled:boolean
AudioContent
Oculto
Leer paralelo
Capacidades: LegacySound
Sound.AudioContent:Content
EmitterSize
Obsoleto
IsLoaded
Solo lectura
No replicado
Leer paralelo
Capacidades: LegacySound
Sound.IsLoaded:boolean
Muestras de código
Cargar Sonido
local sound = script.Parent.Sound



if not sound.IsLoaded then

	sound.Loaded:Wait()

end



print("¡El sonido se ha cargado!")
IsPaused
Oculto
Solo lectura
No replicado
Leer paralelo
Capacidades: LegacySound
Sound.IsPaused:boolean
Muestras de código
Sonido SeEstáReproduciendo y SonidoEstáPausado
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) -- verdadero, falso



task.wait(2)

sound:Pause()

print(sound.IsPlaying, sound.IsPaused) -- falso, verdadero



task.wait(2)

sound:Play()

print(sound.IsPlaying, sound.IsPaused) -- verdadero, falso



task.wait(2)

sound:Stop()

print(sound.IsPlaying, sound.IsPaused) -- falso, verdadero
IsPlaying
Oculto
Solo lectura
No replicado
Leer paralelo
Capacidades: LegacySound
Sound.IsPlaying:boolean
Muestras de código
Sonido SeEstáReproduciendo y SonidoEstáPausado
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) -- verdadero, falso



task.wait(2)

sound:Pause()

print(sound.IsPlaying, sound.IsPaused) -- falso, verdadero



task.wait(2)

sound:Play()

print(sound.IsPlaying, sound.IsPaused) -- verdadero, falso



task.wait(2)

sound:Stop()

print(sound.IsPlaying, sound.IsPaused) -- falso, verdadero
isPlaying
Obsoleto
Looped
Leer paralelo
Capacidades: LegacySound
Sound.Looped:boolean
Muestras de código
Repetir un Número de Veces
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

				-- desconectar la conexión

				connection:Disconnect()

				-- detener el sonido

				sound:Stop()

			end

		end)

		sound:Play()

	end

end



local sound = Instance.new("Sound")

sound.SoundId = "rbxassetid://0"



loopNTimes(sound, 5)
LoopRegion
Leer paralelo
Capacidades: LegacySound
Sound.LoopRegion:NumberRange
MaxDistance
Obsoleto
MinDistance
Obsoleto
Pitch
Obsoleto
PlaybackLoudness
Solo lectura
No replicado
Leer paralelo
Capacidades: LegacySound
Sound.PlaybackLoudness:number
Muestras de código
Barra de Amplitud de Volumen
-- para ser colocado en StarterPlayer > StarterPlayerScripts



local Players = game:GetService("Players")



-- espera al PlayerGui del jugador local

local LocalPlayer = Players.LocalPlayer

local playerGui = LocalPlayer:WaitForChild("PlayerGui")



-- crea un ScreenGui

local screenGui = Instance.new("ScreenGui")

screenGui.Parent = playerGui



-- crea un contenedor para nuestra barra

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



-- crea una barra

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



-- crea un sonido

local sound = Instance.new("Sound")

sound.SoundId = "rbxassetid://9120386436"

sound.Looped = true

sound.Parent = screenGui

sound:Play()



-- define una máxima volumen

local maxLoudness = 30



-- anima la barra de amplitud

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
Leer paralelo
Capacidades: LegacySound
Sound.PlaybackRegion:NumberRange
PlaybackRegionsEnabled
Leer paralelo
Capacidades: LegacySound
Sound.PlaybackRegionsEnabled:boolean
PlaybackSpeed
No replicado
Leer paralelo
Capacidades: LegacySound
Sound.PlaybackSpeed:number
Muestras de código
Velocidad de Reproducción de Sonido
local sound = Instance.new("Sound")

sound.SoundId = "rbxassetid://9120386436"

sound.Looped = true

sound.Parent = workspace



sound:Play()

task.wait(10)

sound.PlaybackSpeed = 3 -- 3x más rápido

task.wait(5)

sound.PlaybackSpeed = 0.5 -- 2x más lento

task.wait(5)

sound.PlaybackSpeed = 1 -- predeterminado
Playing
No replicado
Leer paralelo
Capacidades: LegacySound
Sound.Playing:boolean
Muestras de código
Reproduciendo Sonido
local sound = Instance.new("Sound")

sound.SoundId = "rbxassetid://9120386436"

sound.Looped = true

sound.Parent = workspace



print("reproduciendo sonido")

sound.Playing = true



task.wait(10)



print("deteniendo sonido")

sound.Playing = false



task.wait(5)



sound.Playing = true

local timePosition = sound.TimePosition

print("reanudar en la posición de tiempo: " .. tostring(timePosition)) -- c. 10 segundos
PlayOnRemove
Leer paralelo
Capacidades: LegacySound
Sound.PlayOnRemove:boolean
RollOffMaxDistance
Leer paralelo
Capacidades: LegacySound
Sound.RollOffMaxDistance:number
RollOffMinDistance
Leer paralelo
Capacidades: LegacySound
Sound.RollOffMinDistance:number
RollOffMode
Leer paralelo
Capacidades: LegacySound
Sound.RollOffMode:Enum.RollOffMode
SoundGroup
Leer paralelo
Capacidades: LegacySound
Sound.SoundGroup:SoundGroup
SoundId
Leer paralelo
Capacidades: LegacySound
Sound.SoundId:ContentId
TimeLength
Solo lectura
No replicado
Leer paralelo
Capacidades: LegacySound
Sound.TimeLength:number
Muestras de código
Reproducir un sonido durante una duración específica
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
No replicado
Leer paralelo
Capacidades: LegacySound
Sound.TimePosition:number
Muestras de código
Tiempo de Sonido
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
Volume
Leer paralelo
Capacidades: LegacySound
Sound.Volume:number
Métodos
Pause
Capacidades: LegacySound
Sound:Pause():()
Devuelve
()
Muestras de código
Funciones de Sonido
-- crear un sonido

local sound = Instance.new("Sound", game.Workspace)

sound.SoundId = "rbxassetid://9120386436"



if not sound.IsLoaded then

	sound.Loaded:Wait()

end



-- escuchar eventos

sound.Played:Connect(function(_soundId)

	print("Evento Sound.Played")

end)



sound.Paused:Connect(function(_soundId)

	print("Evento Sound.Paused")

end)



sound.Resumed:Connect(function(_soundId)

	print("Evento Sound.Resumed")

end)



sound.Stopped:Connect(function(_soundId)

	print("Evento Sound.Stopped")

end)



sound:Play()

print("play", sound.Playing, sound.TimePosition) -- play true 0



task.wait(10)



sound:Pause()

print("pause", sound.Playing, sound.TimePosition) -- pause false 10



task.wait(3)



sound:Resume()

print("play", sound.Playing, sound.TimePosition) -- play true 10



task.wait(3)



sound:Stop()

print("stop", sound.Playing, sound.TimePosition) -- stop false 0



task.wait(3)



sound:Play()

print("play", sound.Playing, sound.TimePosition) -- play true 0
pause
Obsoleto
Play
Capacidades: LegacySound
Sound:Play():()
Devuelve
()
Muestras de código
Funciones de Sonido
-- crear un sonido

local sound = Instance.new("Sound", game.Workspace)

sound.SoundId = "rbxassetid://9120386436"



if not sound.IsLoaded then

	sound.Loaded:Wait()

end



-- escuchar eventos

sound.Played:Connect(function(_soundId)

	print("Evento Sound.Played")

end)



sound.Paused:Connect(function(_soundId)

	print("Evento Sound.Paused")

end)



sound.Resumed:Connect(function(_soundId)

	print("Evento Sound.Resumed")

end)



sound.Stopped:Connect(function(_soundId)

	print("Evento Sound.Stopped")

end)



sound:Play()

print("play", sound.Playing, sound.TimePosition) -- play true 0



task.wait(10)



sound:Pause()

print("pause", sound.Playing, sound.TimePosition) -- pause false 10



task.wait(3)



sound:Resume()

print("play", sound.Playing, sound.TimePosition) -- play true 10



task.wait(3)



sound:Stop()

print("stop", sound.Playing, sound.TimePosition) -- stop false 0



task.wait(3)



sound:Play()

print("play", sound.Playing, sound.TimePosition) -- play true 0
play
Obsoleto
Resume
Capacidades: LegacySound
Sound:Resume():()
Devuelve
()
Muestras de código
Funciones de Sonido
-- crear un sonido

local sound = Instance.new("Sound", game.Workspace)

sound.SoundId = "rbxassetid://9120386436"



if not sound.IsLoaded then

	sound.Loaded:Wait()

end



-- escuchar eventos

sound.Played:Connect(function(_soundId)

	print("Evento Sound.Played")

end)



sound.Paused:Connect(function(_soundId)

	print("Evento Sound.Paused")

end)



sound.Resumed:Connect(function(_soundId)

	print("Evento Sound.Resumed")

end)



sound.Stopped:Connect(function(_soundId)

	print("Evento Sound.Stopped")

end)



sound:Play()

print("play", sound.Playing, sound.TimePosition) -- play true 0



task.wait(10)



sound:Pause()

print("pause", sound.Playing, sound.TimePosition) -- pause false 10



task.wait(3)



sound:Resume()

print("play", sound.Playing, sound.TimePosition) -- play true 10



task.wait(3)



sound:Stop()

print("stop", sound.Playing, sound.TimePosition) -- stop false 0



task.wait(3)



sound:Play()

print("play", sound.Playing, sound.TimePosition) -- play true 0
Stop
Capacidades: LegacySound
Sound:Stop():()
Devuelve
()
Muestras de código
Funciones de Sonido
-- crear un sonido

local sound = Instance.new("Sound", game.Workspace)

sound.SoundId = "rbxassetid://9120386436"



if not sound.IsLoaded then

	sound.Loaded:Wait()

end



-- escuchar eventos

sound.Played:Connect(function(_soundId)

	print("Evento Sound.Played")

end)



sound.Paused:Connect(function(_soundId)

	print("Evento Sound.Paused")

end)



sound.Resumed:Connect(function(_soundId)

	print("Evento Sound.Resumed")

end)



sound.Stopped:Connect(function(_soundId)

	print("Evento Sound.Stopped")

end)



sound:Play()

print("play", sound.Playing, sound.TimePosition) -- play true 0



task.wait(10)



sound:Pause()

print("pause", sound.Playing, sound.TimePosition) -- pause false 10



task.wait(3)



sound:Resume()

print("play", sound.Playing, sound.TimePosition) -- play true 10



task.wait(3)



sound:Stop()

print("stop", sound.Playing, sound.TimePosition) -- stop false 0



task.wait(3)



sound:Play()

print("play", sound.Playing, sound.TimePosition) -- play true 0
stop
Obsoleto
Eventos
DidLoop
Capacidades: LegacySound
Sound.DidLoop(
soundId:string, numOfTimesLooped:number
Parámetros
soundId:string
numOfTimesLooped:number
Muestras de código
Repetir un Número de Veces
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

				-- desconectar la conexión

				connection:Disconnect()

				-- detener el sonido

				sound:Stop()

			end

		end)

		sound:Play()

	end

end



local sound = Instance.new("Sound")

sound.SoundId = "rbxassetid://0"



loopNTimes(sound, 5)
Ended
Capacidades: LegacySound
Sound.Ended(soundId:string):RBXScriptSignal
Parámetros
soundId:string
Loaded
Capacidades: LegacySound
Sound.Loaded(soundId:string):RBXScriptSignal
Parámetros
soundId:string
Muestras de código
Cargar Sonido
local sound = script.Parent.Sound



if not sound.IsLoaded then

	sound.Loaded:Wait()

end



print("¡El sonido se ha cargado!")
Paused
Capacidades: LegacySound
Sound.Paused(soundId:string):RBXScriptSignal
Parámetros
soundId:string
Muestras de código
Funciones de Sonido
-- crear un sonido

local sound = Instance.new("Sound", game.Workspace)

sound.SoundId = "rbxassetid://9120386436"



if not sound.IsLoaded then

	sound.Loaded:Wait()

end



-- escuchar eventos

sound.Played:Connect(function(_soundId)

	print("Evento Sound.Played")

end)



sound.Paused:Connect(function(_soundId)

	print("Evento Sound.Paused")

end)



sound.Resumed:Connect(function(_soundId)

	print("Evento Sound.Resumed")

end)



sound.Stopped:Connect(function(_soundId)

	print("Evento Sound.Stopped")

end)



sound:Play()

print("play", sound.Playing, sound.TimePosition) -- play true 0



task.wait(10)



sound:Pause()

print("pause", sound.Playing, sound.TimePosition) -- pause false 10



task.wait(3)



sound:Resume()

print("play", sound.Playing, sound.TimePosition) -- play true 10



task.wait(3)



sound:Stop()

print("stop", sound.Playing, sound.TimePosition) -- stop false 0



task.wait(3)



sound:Play()

print("play", sound.Playing, sound.TimePosition) -- play true 0
Played
Capacidades: LegacySound
Sound.Played(soundId:string):RBXScriptSignal
Parámetros
soundId:string
Muestras de código
Funciones de Sonido
-- crear un sonido

local sound = Instance.new("Sound", game.Workspace)

sound.SoundId = "rbxassetid://9120386436"



if not sound.IsLoaded then

	sound.Loaded:Wait()

end



-- escuchar eventos

sound.Played:Connect(function(_soundId)

	print("Evento Sound.Played")

end)



sound.Paused:Connect(function(_soundId)

	print("Evento Sound.Paused")

end)



sound.Resumed:Connect(function(_soundId)

	print("Evento Sound.Resumed")

end)



sound.Stopped:Connect(function(_soundId)

	print("Evento Sound.Stopped")

end)



sound:Play()

print("play", sound.Playing, sound.TimePosition) -- play true 0



task.wait(10)



sound:Pause()

print("pause", sound.Playing, sound.TimePosition) -- pause false 10



task.wait(3)



sound:Resume()

print("play", sound.Playing, sound.TimePosition) -- play true 10



task.wait(3)



sound:Stop()

print("stop", sound.Playing, sound.TimePosition) -- stop false 0



task.wait(3)



sound:Play()

print("play", sound.Playing, sound.TimePosition) -- play true 0
Resumed
Capacidades: LegacySound
Sound.Resumed(soundId:string):RBXScriptSignal
Parámetros
soundId:string
Muestras de código
Funciones de Sonido
-- crear un sonido

local sound = Instance.new("Sound", game.Workspace)

sound.SoundId = "rbxassetid://9120386436"



if not sound.IsLoaded then

	sound.Loaded:Wait()

end



-- escuchar eventos

sound.Played:Connect(function(_soundId)

	print("Evento Sound.Played")

end)



sound.Paused:Connect(function(_soundId)

	print("Evento Sound.Paused")

end)



sound.Resumed:Connect(function(_soundId)

	print("Evento Sound.Resumed")

end)



sound.Stopped:Connect(function(_soundId)

	print("Evento Sound.Stopped")

end)



sound:Play()

print("play", sound.Playing, sound.TimePosition) -- play true 0



task.wait(10)



sound:Pause()

print("pause", sound.Playing, sound.TimePosition) -- pause false 10



task.wait(3)



sound:Resume()

print("play", sound.Playing, sound.TimePosition) -- play true 10



task.wait(3)



sound:Stop()

print("stop", sound.Playing, sound.TimePosition) -- stop false 0



task.wait(3)



sound:Play()

print("play", sound.Playing, sound.TimePosition) -- play true 0
Stopped
Capacidades: LegacySound
Sound.Stopped(soundId:string):RBXScriptSignal
Parámetros
soundId:string
Muestras de código
Funciones de Sonido
-- crear un sonido

local sound = Instance.new("Sound", game.Workspace)

sound.SoundId = "rbxassetid://9120386436"



if not sound.IsLoaded then

	sound.Loaded:Wait()

end



-- escuchar eventos

sound.Played:Connect(function(_soundId)

	print("Evento Sound.Played")

end)



sound.Paused:Connect(function(_soundId)

	print("Evento Sound.Paused")

end)



sound.Resumed:Connect(function(_soundId)

	print("Evento Sound.Resumed")

end)



sound.Stopped:Connect(function(_soundId)

	print("Evento Sound.Stopped")

end)



sound:Play()

print("play", sound.Playing, sound.TimePosition) -- play true 0



task.wait(10)



sound:Pause()

print("pause", sound.Playing, sound.TimePosition) -- pause false 10



task.wait(3)



sound:Resume()

print("play", sound.Playing, sound.TimePosition) -- play true 10



task.wait(3)



sound:Stop()

print("stop", sound.Playing, sound.TimePosition) -- stop false 0



task.wait(3)



sound:Play()

print("play", sound.Playing, sound.TimePosition) -- play true 0
©2026 Roblox Corporation. Roblox, el logotipo de Roblox y "Powering Imagination" son algunas de nuestras marcas registradas y no registradas en los Estados Unidos y otros países.
Términos·Privacidad·Accesibilidad·Soporte
Español