Twórca
​
Interfejs API silnika
Informacje o wersji
Edukacja
Klasa silnika
Sound

*Ta zawartość została przetłumaczona przy użyciu narzędzi AI (w wersji beta) i może zawierać błędy. Aby wyświetlić tę stronę w języku angielskim, kliknij tutaj.

Podsumowanie
Metody
Pause():()
pause():()
Przestarzałe
Play():()
play():()
Przestarzałe
Resume():()
Stop():()
stop():()
Przestarzałe
Członkowie odziedziczeni
Przykłady kodu
Część odtwarzania muzyki
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



-- utwórz dźwięk

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

sound.SoundId = "rbxassetid://9120386436"

sound.EmitterSize = 5 -- zmniejsz rozmiar emitera (dla wcześniejszego spadku głośności)

sound.Looped = true

sound.Parent = part



local clickDetector = Instance.new("ClickDetector")

clickDetector.Parent = part



-- przełącz odtwarzanie dźwięku / nie odtwarzanie

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)
Materiały referencyjne dotyczące interfejsów API
Właściwości
AcousticSimulationEnabled
Odczyt równoległy
Możliwości: LegacySound
Sound.AcousticSimulationEnabled:boolean
AudioContent
Ukryte
Odczyt równoległy
Możliwości: LegacySound
Sound.AudioContent:Content
EmitterSize
Przestarzałe
IsLoaded
Tylko do odczytu
Bez replikacji
Odczyt równoległy
Możliwości: LegacySound
Sound.IsLoaded:boolean
Przykłady kodu
Załaduj dźwięk
local sound = script.Parent.Sound



if not sound.IsLoaded then

	sound.Loaded:Wait()

end



print("Dźwięk został załadowany!")
IsPaused
Ukryte
Tylko do odczytu
Bez replikacji
Odczyt równoległy
Możliwości: LegacySound
Sound.IsPaused:boolean
Przykłady kodu
Dźwięk IsPlaying i SoundIsPaused
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) -- prawda, fałsz



task.wait(2)

sound:Pause()

print(sound.IsPlaying, sound.IsPaused) -- fałsz, prawda



task.wait(2)

sound:Play()

print(sound.IsPlaying, sound.IsPaused) -- prawda, fałsz



task.wait(2)

sound:Stop()

print(sound.IsPlaying, sound.IsPaused) -- fałsz, prawda
IsPlaying
Ukryte
Tylko do odczytu
Bez replikacji
Odczyt równoległy
Możliwości: LegacySound
Sound.IsPlaying:boolean
Przykłady kodu
Dźwięk IsPlaying i SoundIsPaused
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) -- prawda, fałsz



task.wait(2)

sound:Pause()

print(sound.IsPlaying, sound.IsPaused) -- fałsz, prawda



task.wait(2)

sound:Play()

print(sound.IsPlaying, sound.IsPaused) -- prawda, fałsz



task.wait(2)

sound:Stop()

print(sound.IsPlaying, sound.IsPaused) -- fałsz, prawda
isPlaying
Przestarzałe
Looped
Odczyt równoległy
Możliwości: LegacySound
Sound.Looped:boolean
Przykłady kodu
Pętla przez określoną liczbę razy
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

				-- odłącz połączenie

				connection:Disconnect()

				-- zatrzymaj dźwięk

				sound:Stop()

			end

		end)

		sound:Play()

	end

end



local sound = Instance.new("Sound")

sound.SoundId = "rbxassetid://0"



loopNTimes(sound, 5)
LoopRegion
Odczyt równoległy
Możliwości: LegacySound
Sound.LoopRegion:NumberRange
MaxDistance
Przestarzałe
MinDistance
Przestarzałe
Pitch
Przestarzałe
PlaybackLoudness
Tylko do odczytu
Bez replikacji
Odczyt równoległy
Możliwości: LegacySound
Sound.PlaybackLoudness:number
Przykłady kodu
Wskaźnik Amplitudy Głośności
-- do umieszczenia w StarterPlayer > StarterPlayerScripts



local Players = game:GetService("Players")



-- czekaj na lokalnego gracza PlayerGui

local LocalPlayer = Players.LocalPlayer

local playerGui = LocalPlayer:WaitForChild("PlayerGui")



-- utwórz ScreenGui

local screenGui = Instance.new("ScreenGui")

screenGui.Parent = playerGui



-- utwórz ramkę dla naszego wskaźnika

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



-- utwórz wskaźnik

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



-- utwórz dźwięk

local sound = Instance.new("Sound")

sound.SoundId = "rbxassetid://9120386436"

sound.Looped = true

sound.Parent = screenGui

sound:Play()



-- zdefiniuj maksymalną głośność

local maxLoudness = 30



-- animuj wskaźnik amplitudy

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
Odczyt równoległy
Możliwości: LegacySound
Sound.PlaybackRegion:NumberRange
PlaybackRegionsEnabled
Odczyt równoległy
Możliwości: LegacySound
Sound.PlaybackRegionsEnabled:boolean
PlaybackSpeed
Bez replikacji
Odczyt równoległy
Możliwości: LegacySound
Sound.PlaybackSpeed:number
Przykłady kodu
Prędkość Odtwarzania Dźwięku
local sound = Instance.new("Sound")

sound.SoundId = "rbxassetid://9120386436"

sound.Looped = true

sound.Parent = workspace



sound:Play()

task.wait(10)

sound.PlaybackSpeed = 3 -- 3x szybciej

task.wait(5)

sound.PlaybackSpeed = 0.5 -- 2x wolniej

task.wait(5)

sound.PlaybackSpeed = 1 -- domyślnie
Playing
Bez replikacji
Odczyt równoległy
Możliwości: LegacySound
Sound.Playing:boolean
Przykłady kodu
Odtwarzanie dźwięku
local sound = Instance.new("Sound")

sound.SoundId = "rbxassetid://9120386436"

sound.Looped = true

sound.Parent = workspace



print("odtwarzanie dźwięku")

sound.Playing = true



task.wait(10)



print("zatrzymywanie dźwięku")

sound.Playing = false



task.wait(5)



sound.Playing = true

local timePosition = sound.TimePosition

print("wznawiane na pozycji czasu: " .. tostring(timePosition)) -- c. 10 sekund
PlayOnRemove
Odczyt równoległy
Możliwości: LegacySound
Sound.PlayOnRemove:boolean
RollOffMaxDistance
Odczyt równoległy
Możliwości: LegacySound
Sound.RollOffMaxDistance:number
RollOffMinDistance
Odczyt równoległy
Możliwości: LegacySound
Sound.RollOffMinDistance:number
RollOffMode
Odczyt równoległy
Możliwości: LegacySound
Sound.RollOffMode:Enum.RollOffMode
SoundGroup
Odczyt równoległy
Możliwości: LegacySound
Sound.SoundGroup:SoundGroup
SoundId
Odczyt równoległy
Możliwości: LegacySound
Sound.SoundId:ContentId
TimeLength
Tylko do odczytu
Bez replikacji
Odczyt równoległy
Możliwości: LegacySound
Sound.TimeLength:number
Przykłady kodu
Odtwarzaj dźwięk przez określony czas
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
Bez replikacji
Odczyt równoległy
Możliwości: LegacySound
Sound.TimePosition:number
Przykłady kodu
PozycjaCzasuDźwięku
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
Odczyt równoległy
Możliwości: LegacySound
Sound.Volume:number
Metody
Pause
Możliwości: LegacySound
Sound:Pause():()
Zwroty
()
Przykłady kodu
Funkcje Dźwięku
-- utwórz dźwięk

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

sound.SoundId = "rbxassetid://9120386436"



if not sound.IsLoaded then

	sound.Loaded:Wait()

end



-- nasłuchuj zdarzenia

sound.Played:Connect(function(_soundId)

	print("Zdarzenie Sound.Played")

end)



sound.Paused:Connect(function(_soundId)

	print("Zdarzenie Sound.Paused")

end)



sound.Resumed:Connect(function(_soundId)

	print("Zdarzenie Sound.Resumed")

end)



sound.Stopped:Connect(function(_soundId)

	print("Zdarzenie Sound.Stopped")

end)



sound:Play()

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



task.wait(10)



sound:Pause()

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



task.wait(3)



sound:Resume()

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



task.wait(3)



sound:Stop()

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



task.wait(3)



sound:Play()

print("odtwarzaj", sound.Playing, sound.TimePosition) -- odtwarzaj true 0
pause
Przestarzałe
Play
Możliwości: LegacySound
Sound:Play():()
Zwroty
()
Przykłady kodu
Funkcje Dźwięku
-- utwórz dźwięk

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

sound.SoundId = "rbxassetid://9120386436"



if not sound.IsLoaded then

	sound.Loaded:Wait()

end



-- nasłuchuj zdarzenia

sound.Played:Connect(function(_soundId)

	print("Zdarzenie Sound.Played")

end)



sound.Paused:Connect(function(_soundId)

	print("Zdarzenie Sound.Paused")

end)



sound.Resumed:Connect(function(_soundId)

	print("Zdarzenie Sound.Resumed")

end)



sound.Stopped:Connect(function(_soundId)

	print("Zdarzenie Sound.Stopped")

end)



sound:Play()

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



task.wait(10)



sound:Pause()

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



task.wait(3)



sound:Resume()

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



task.wait(3)



sound:Stop()

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



task.wait(3)



sound:Play()

print("odtwarzaj", sound.Playing, sound.TimePosition) -- odtwarzaj true 0
play
Przestarzałe
Resume
Możliwości: LegacySound
Sound:Resume():()
Zwroty
()
Przykłady kodu
Funkcje Dźwięku
-- utwórz dźwięk

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

sound.SoundId = "rbxassetid://9120386436"



if not sound.IsLoaded then

	sound.Loaded:Wait()

end



-- nasłuchuj zdarzenia

sound.Played:Connect(function(_soundId)

	print("Zdarzenie Sound.Played")

end)



sound.Paused:Connect(function(_soundId)

	print("Zdarzenie Sound.Paused")

end)



sound.Resumed:Connect(function(_soundId)

	print("Zdarzenie Sound.Resumed")

end)



sound.Stopped:Connect(function(_soundId)

	print("Zdarzenie Sound.Stopped")

end)



sound:Play()

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



task.wait(10)



sound:Pause()

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



task.wait(3)



sound:Resume()

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



task.wait(3)



sound:Stop()

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



task.wait(3)



sound:Play()

print("odtwarzaj", sound.Playing, sound.TimePosition) -- odtwarzaj true 0
Stop
Możliwości: LegacySound
Sound:Stop():()
Zwroty
()
Przykłady kodu
Funkcje Dźwięku
-- utwórz dźwięk

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

sound.SoundId = "rbxassetid://9120386436"



if not sound.IsLoaded then

	sound.Loaded:Wait()

end



-- nasłuchuj zdarzenia

sound.Played:Connect(function(_soundId)

	print("Zdarzenie Sound.Played")

end)



sound.Paused:Connect(function(_soundId)

	print("Zdarzenie Sound.Paused")

end)



sound.Resumed:Connect(function(_soundId)

	print("Zdarzenie Sound.Resumed")

end)



sound.Stopped:Connect(function(_soundId)

	print("Zdarzenie Sound.Stopped")

end)



sound:Play()

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



task.wait(10)



sound:Pause()

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



task.wait(3)



sound:Resume()

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



task.wait(3)



sound:Stop()

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



task.wait(3)



sound:Play()

print("odtwarzaj", sound.Playing, sound.TimePosition) -- odtwarzaj true 0
stop
Przestarzałe
Zdarzenia
DidLoop
Możliwości: LegacySound
Sound.DidLoop(
soundId:string, numOfTimesLooped:number
Parametry
soundId:string
numOfTimesLooped:number
Przykłady kodu
Pętla przez określoną liczbę razy
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

				-- odłącz połączenie

				connection:Disconnect()

				-- zatrzymaj dźwięk

				sound:Stop()

			end

		end)

		sound:Play()

	end

end



local sound = Instance.new("Sound")

sound.SoundId = "rbxassetid://0"



loopNTimes(sound, 5)
Ended
Możliwości: LegacySound
Sound.Ended(soundId:string):RBXScriptSignal
Parametry
soundId:string
Loaded
Możliwości: LegacySound
Sound.Loaded(soundId:string):RBXScriptSignal
Parametry
soundId:string
Przykłady kodu
Załaduj dźwięk
local sound = script.Parent.Sound



if not sound.IsLoaded then

	sound.Loaded:Wait()

end



print("Dźwięk został załadowany!")
Paused
Możliwości: LegacySound
Sound.Paused(soundId:string):RBXScriptSignal
Parametry
soundId:string
Przykłady kodu
Funkcje Dźwięku
-- utwórz dźwięk

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

sound.SoundId = "rbxassetid://9120386436"



if not sound.IsLoaded then

	sound.Loaded:Wait()

end



-- nasłuchuj zdarzenia

sound.Played:Connect(function(_soundId)

	print("Zdarzenie Sound.Played")

end)



sound.Paused:Connect(function(_soundId)

	print("Zdarzenie Sound.Paused")

end)



sound.Resumed:Connect(function(_soundId)

	print("Zdarzenie Sound.Resumed")

end)



sound.Stopped:Connect(function(_soundId)

	print("Zdarzenie Sound.Stopped")

end)



sound:Play()

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



task.wait(10)



sound:Pause()

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



task.wait(3)



sound:Resume()

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



task.wait(3)



sound:Stop()

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



task.wait(3)



sound:Play()

print("odtwarzaj", sound.Playing, sound.TimePosition) -- odtwarzaj true 0
Played
Możliwości: LegacySound
Sound.Played(soundId:string):RBXScriptSignal
Parametry
soundId:string
Przykłady kodu
Funkcje Dźwięku
-- utwórz dźwięk

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

sound.SoundId = "rbxassetid://9120386436"



if not sound.IsLoaded then

	sound.Loaded:Wait()

end



-- nasłuchuj zdarzenia

sound.Played:Connect(function(_soundId)

	print("Zdarzenie Sound.Played")

end)



sound.Paused:Connect(function(_soundId)

	print("Zdarzenie Sound.Paused")

end)



sound.Resumed:Connect(function(_soundId)

	print("Zdarzenie Sound.Resumed")

end)



sound.Stopped:Connect(function(_soundId)

	print("Zdarzenie Sound.Stopped")

end)



sound:Play()

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



task.wait(10)



sound:Pause()

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



task.wait(3)



sound:Resume()

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



task.wait(3)



sound:Stop()

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



task.wait(3)



sound:Play()

print("odtwarzaj", sound.Playing, sound.TimePosition) -- odtwarzaj true 0
Resumed
Możliwości: LegacySound
Sound.Resumed(soundId:string):RBXScriptSignal
Parametry
soundId:string
Przykłady kodu
Funkcje Dźwięku
-- utwórz dźwięk

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

sound.SoundId = "rbxassetid://9120386436"



if not sound.IsLoaded then

	sound.Loaded:Wait()

end



-- nasłuchuj zdarzenia

sound.Played:Connect(function(_soundId)

	print("Zdarzenie Sound.Played")

end)



sound.Paused:Connect(function(_soundId)

	print("Zdarzenie Sound.Paused")

end)



sound.Resumed:Connect(function(_soundId)

	print("Zdarzenie Sound.Resumed")

end)



sound.Stopped:Connect(function(_soundId)

	print("Zdarzenie Sound.Stopped")

end)



sound:Play()

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



task.wait(10)



sound:Pause()

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



task.wait(3)



sound:Resume()

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



task.wait(3)



sound:Stop()

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



task.wait(3)



sound:Play()

print("odtwarzaj", sound.Playing, sound.TimePosition) -- odtwarzaj true 0
Stopped
Możliwości: LegacySound
Sound.Stopped(soundId:string):RBXScriptSignal
Parametry
soundId:string
Przykłady kodu
Funkcje Dźwięku
-- utwórz dźwięk

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

sound.SoundId = "rbxassetid://9120386436"



if not sound.IsLoaded then

	sound.Loaded:Wait()

end



-- nasłuchuj zdarzenia

sound.Played:Connect(function(_soundId)

	print("Zdarzenie Sound.Played")

end)



sound.Paused:Connect(function(_soundId)

	print("Zdarzenie Sound.Paused")

end)



sound.Resumed:Connect(function(_soundId)

	print("Zdarzenie Sound.Resumed")

end)



sound.Stopped:Connect(function(_soundId)

	print("Zdarzenie Sound.Stopped")

end)



sound:Play()

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



task.wait(10)



sound:Pause()

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



task.wait(3)



sound:Resume()

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



task.wait(3)



sound:Stop()

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



task.wait(3)



sound:Play()

print("odtwarzaj", sound.Playing, sound.TimePosition) -- odtwarzaj true 0
©2026 Roblox Corporation. Nazwa Roblox, logo Roblox oraz hasło „Powering Imagination” należą do naszych zarejestrowanych i niezarejestrowanych znaków towarowych na terenie Stanów Zjednoczonych oraz w innych krajach.
Warunki·Prywatność·Dostępność·Wsparcie
Polski