Engine-Klasse
Sound
*Dieser Inhalt wurde mit KI (Beta) übersetzt und kann Fehler enthalten. Um diese Seite auf Englisch zu sehen, klicke hier.
Zusammenfassung
Eigenschaften
SoundId:ContentId |
Events
DidLoop(soundId: string,numOfTimesLooped: number):RBXScriptSignal |
Ended(soundId: string):RBXScriptSignal |
Loaded(soundId: string):RBXScriptSignal |
Paused(soundId: string):RBXScriptSignal |
Played(soundId: string):RBXScriptSignal |
Resumed(soundId: string):RBXScriptSignal |
Stopped(soundId: string):RBXScriptSignal |
Code-Beispiele
Musik Spielender Teil
local part = Instance.new("Part")
part.Anchored = true
part.Position = Vector3.new(0, 3, 0)
part.BrickColor = BrickColor.new("Hellrot")
part.Name = "Musikbox"
part.Parent = workspace
-- ein Geräusch erstellen
local sound = Instance.new("Sound", part)
sound.SoundId = "rbxassetid://9120386436"
sound.EmitterSize = 5 -- verringere die Emittergröße (für frühere Lautstärkeabnahme)
sound.Looped = true
sound.Parent = part
local clickDetector = Instance.new("ClickDetector")
clickDetector.Parent = part
-- das Abspielen des Sounds ein- / ausschalten
clickDetector.MouseClick:Connect(function()
if not sound.IsPlaying then
part.BrickColor = BrickColor.new("Hellgrün")
sound:Play()
else
part.BrickColor = BrickColor.new("Hellrot")
sound:Stop()
end
end)API-Referenz
Eigenschaften
EmitterSize
IsLoaded
Code-Beispiele
Geräusch laden
local sound = script.Parent.Sound
if not sound.IsLoaded then
sound.Loaded:Wait()
end
print("Das Geräusch wurde geladen!")IsPaused
Code-Beispiele
Sound IsPlaying und 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) -- wahr, falsch
task.wait(2)
sound:Pause()
print(sound.IsPlaying, sound.IsPaused) -- falsch, wahr
task.wait(2)
sound:Play()
print(sound.IsPlaying, sound.IsPaused) -- wahr, falsch
task.wait(2)
sound:Stop()
print(sound.IsPlaying, sound.IsPaused) -- falsch, wahrIsPlaying
Code-Beispiele
Sound IsPlaying und 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) -- wahr, falsch
task.wait(2)
sound:Pause()
print(sound.IsPlaying, sound.IsPaused) -- falsch, wahr
task.wait(2)
sound:Play()
print(sound.IsPlaying, sound.IsPaused) -- wahr, falsch
task.wait(2)
sound:Stop()
print(sound.IsPlaying, sound.IsPaused) -- falsch, wahrisPlaying
Looped
Code-Beispiele
Zahl mehrmals wiederholen
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
-- die Verbindung trennen
connection:Disconnect()
-- den Sound stoppen
sound:Stop()
end
end)
sound:Play()
end
end
local sound = Instance.new("Sound")
sound.SoundId = "rbxassetid://0"
loopNTimes(sound, 5)MaxDistance
MinDistance
Pitch
PlaybackLoudness
Code-Beispiele
Lautstärke Amplitudenanzeige
-- muss in StarterPlayer > StarterPlayerScripts platziert werden
local Players = game:GetService("Players")
-- auf den lokalen Spieler PlayerGui warten
local LocalPlayer = Players.LocalPlayer
local playerGui = LocalPlayer:WaitForChild("PlayerGui")
-- ein ScreenGui erstellen
local screenGui = Instance.new("ScreenGui")
screenGui.Parent = playerGui
-- einen Halter für unsere Anzeige erstellen
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
-- eine Anzeige erstellen
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
-- einen Ton erstellen
local sound = Instance.new("Sound")
sound.SoundId = "rbxassetid://9120386436"
sound.Looped = true
sound.Parent = screenGui
sound:Play()
-- eine maximale Lautstärke definieren
local maxLoudness = 30
-- die Amplitudenanzeige animieren
while true do
local amplitude = math.clamp(sound.PlaybackLoudness / maxLoudness, 0, 1)
bar.Size = UDim2.new(amplitude, 0, 1, 0)
wait(0.05)
endPlaybackSpeed
Code-Beispiele
Sound Wiedergabegeschwindigkeit
local sound = Instance.new("Sound")
sound.SoundId = "rbxassetid://9120386436"
sound.Looped = true
sound.Parent = workspace
sound:Play()
task.wait(10)
sound.PlaybackSpeed = 3 -- 3x schneller
task.wait(5)
sound.PlaybackSpeed = 0.5 -- 2x langsamer
task.wait(5)
sound.PlaybackSpeed = 1 -- StandardPlaying
Code-Beispiele
Ton Wiedergabe
local sound = Instance.new("Sound")
sound.SoundId = "rbxassetid://9120386436"
sound.Looped = true
sound.Parent = workspace
print("Spiele Sound")
sound.Playing = true
task.wait(10)
print("Stoppe Sound")
sound.Playing = false
task.wait(5)
sound.Playing = true
local timePosition = sound.TimePosition
print("Fortgesetzt an der Zeitposition: " .. tostring(timePosition)) -- ca. 10 SekundenSoundId
Sound.SoundId:ContentId
TimeLength
Code-Beispiele
Spiele einen Sound für eine bestimmte Dauer
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
Code-Beispiele
Sound Zeitposition
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 = 0Methoden
Pause
Sound:Pause():()
Rückgaben
()
Code-Beispiele
Sound-Funktionen
-- Erstelle einen Sound
local sound = Instance.new("Sound", game.Workspace)
sound.SoundId = "rbxassetid://9120386436"
if not sound.IsLoaded then
sound.Loaded:Wait()
end
-- Höre auf Ereignisse
sound.Played:Connect(function(_soundId)
print("Sound.Played Ereignis")
end)
sound.Paused:Connect(function(_soundId)
print("Sound.Paused Ereignis")
end)
sound.Resumed:Connect(function(_soundId)
print("Sound.Resumed Ereignis")
end)
sound.Stopped:Connect(function(_soundId)
print("Sound.Stopped Ereignis")
end)
sound:Play()
print("spielen", sound.Playing, sound.TimePosition) -- spielen true 0
task.wait(10)
sound:Pause()
print("pausieren", sound.Playing, sound.TimePosition) -- pausieren false 10
task.wait(3)
sound:Resume()
print("spielen", sound.Playing, sound.TimePosition) -- spielen true 10
task.wait(3)
sound:Stop()
print("stoppen", sound.Playing, sound.TimePosition) -- stoppen false 0
task.wait(3)
sound:Play()
print("spielen", sound.Playing, sound.TimePosition) -- spielen true 0pause
Play
Sound:Play():()
Rückgaben
()
Code-Beispiele
Sound-Funktionen
-- Erstelle einen Sound
local sound = Instance.new("Sound", game.Workspace)
sound.SoundId = "rbxassetid://9120386436"
if not sound.IsLoaded then
sound.Loaded:Wait()
end
-- Höre auf Ereignisse
sound.Played:Connect(function(_soundId)
print("Sound.Played Ereignis")
end)
sound.Paused:Connect(function(_soundId)
print("Sound.Paused Ereignis")
end)
sound.Resumed:Connect(function(_soundId)
print("Sound.Resumed Ereignis")
end)
sound.Stopped:Connect(function(_soundId)
print("Sound.Stopped Ereignis")
end)
sound:Play()
print("spielen", sound.Playing, sound.TimePosition) -- spielen true 0
task.wait(10)
sound:Pause()
print("pausieren", sound.Playing, sound.TimePosition) -- pausieren false 10
task.wait(3)
sound:Resume()
print("spielen", sound.Playing, sound.TimePosition) -- spielen true 10
task.wait(3)
sound:Stop()
print("stoppen", sound.Playing, sound.TimePosition) -- stoppen false 0
task.wait(3)
sound:Play()
print("spielen", sound.Playing, sound.TimePosition) -- spielen true 0play
Resume
Sound:Resume():()
Rückgaben
()
Code-Beispiele
Sound-Funktionen
-- Erstelle einen Sound
local sound = Instance.new("Sound", game.Workspace)
sound.SoundId = "rbxassetid://9120386436"
if not sound.IsLoaded then
sound.Loaded:Wait()
end
-- Höre auf Ereignisse
sound.Played:Connect(function(_soundId)
print("Sound.Played Ereignis")
end)
sound.Paused:Connect(function(_soundId)
print("Sound.Paused Ereignis")
end)
sound.Resumed:Connect(function(_soundId)
print("Sound.Resumed Ereignis")
end)
sound.Stopped:Connect(function(_soundId)
print("Sound.Stopped Ereignis")
end)
sound:Play()
print("spielen", sound.Playing, sound.TimePosition) -- spielen true 0
task.wait(10)
sound:Pause()
print("pausieren", sound.Playing, sound.TimePosition) -- pausieren false 10
task.wait(3)
sound:Resume()
print("spielen", sound.Playing, sound.TimePosition) -- spielen true 10
task.wait(3)
sound:Stop()
print("stoppen", sound.Playing, sound.TimePosition) -- stoppen false 0
task.wait(3)
sound:Play()
print("spielen", sound.Playing, sound.TimePosition) -- spielen true 0Stop
Sound:Stop():()
Rückgaben
()
Code-Beispiele
Sound-Funktionen
-- Erstelle einen Sound
local sound = Instance.new("Sound", game.Workspace)
sound.SoundId = "rbxassetid://9120386436"
if not sound.IsLoaded then
sound.Loaded:Wait()
end
-- Höre auf Ereignisse
sound.Played:Connect(function(_soundId)
print("Sound.Played Ereignis")
end)
sound.Paused:Connect(function(_soundId)
print("Sound.Paused Ereignis")
end)
sound.Resumed:Connect(function(_soundId)
print("Sound.Resumed Ereignis")
end)
sound.Stopped:Connect(function(_soundId)
print("Sound.Stopped Ereignis")
end)
sound:Play()
print("spielen", sound.Playing, sound.TimePosition) -- spielen true 0
task.wait(10)
sound:Pause()
print("pausieren", sound.Playing, sound.TimePosition) -- pausieren false 10
task.wait(3)
sound:Resume()
print("spielen", sound.Playing, sound.TimePosition) -- spielen true 10
task.wait(3)
sound:Stop()
print("stoppen", sound.Playing, sound.TimePosition) -- stoppen false 0
task.wait(3)
sound:Play()
print("spielen", sound.Playing, sound.TimePosition) -- spielen true 0stop
Events
DidLoop
Code-Beispiele
Zahl mehrmals wiederholen
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
-- die Verbindung trennen
connection:Disconnect()
-- den Sound stoppen
sound:Stop()
end
end)
sound:Play()
end
end
local sound = Instance.new("Sound")
sound.SoundId = "rbxassetid://0"
loopNTimes(sound, 5)Loaded
Parameter
Code-Beispiele
Geräusch laden
local sound = script.Parent.Sound
if not sound.IsLoaded then
sound.Loaded:Wait()
end
print("Das Geräusch wurde geladen!")Paused
Parameter
Code-Beispiele
Sound-Funktionen
-- Erstelle einen Sound
local sound = Instance.new("Sound", game.Workspace)
sound.SoundId = "rbxassetid://9120386436"
if not sound.IsLoaded then
sound.Loaded:Wait()
end
-- Höre auf Ereignisse
sound.Played:Connect(function(_soundId)
print("Sound.Played Ereignis")
end)
sound.Paused:Connect(function(_soundId)
print("Sound.Paused Ereignis")
end)
sound.Resumed:Connect(function(_soundId)
print("Sound.Resumed Ereignis")
end)
sound.Stopped:Connect(function(_soundId)
print("Sound.Stopped Ereignis")
end)
sound:Play()
print("spielen", sound.Playing, sound.TimePosition) -- spielen true 0
task.wait(10)
sound:Pause()
print("pausieren", sound.Playing, sound.TimePosition) -- pausieren false 10
task.wait(3)
sound:Resume()
print("spielen", sound.Playing, sound.TimePosition) -- spielen true 10
task.wait(3)
sound:Stop()
print("stoppen", sound.Playing, sound.TimePosition) -- stoppen false 0
task.wait(3)
sound:Play()
print("spielen", sound.Playing, sound.TimePosition) -- spielen true 0Played
Parameter
Code-Beispiele
Sound-Funktionen
-- Erstelle einen Sound
local sound = Instance.new("Sound", game.Workspace)
sound.SoundId = "rbxassetid://9120386436"
if not sound.IsLoaded then
sound.Loaded:Wait()
end
-- Höre auf Ereignisse
sound.Played:Connect(function(_soundId)
print("Sound.Played Ereignis")
end)
sound.Paused:Connect(function(_soundId)
print("Sound.Paused Ereignis")
end)
sound.Resumed:Connect(function(_soundId)
print("Sound.Resumed Ereignis")
end)
sound.Stopped:Connect(function(_soundId)
print("Sound.Stopped Ereignis")
end)
sound:Play()
print("spielen", sound.Playing, sound.TimePosition) -- spielen true 0
task.wait(10)
sound:Pause()
print("pausieren", sound.Playing, sound.TimePosition) -- pausieren false 10
task.wait(3)
sound:Resume()
print("spielen", sound.Playing, sound.TimePosition) -- spielen true 10
task.wait(3)
sound:Stop()
print("stoppen", sound.Playing, sound.TimePosition) -- stoppen false 0
task.wait(3)
sound:Play()
print("spielen", sound.Playing, sound.TimePosition) -- spielen true 0Resumed
Parameter
Code-Beispiele
Sound-Funktionen
-- Erstelle einen Sound
local sound = Instance.new("Sound", game.Workspace)
sound.SoundId = "rbxassetid://9120386436"
if not sound.IsLoaded then
sound.Loaded:Wait()
end
-- Höre auf Ereignisse
sound.Played:Connect(function(_soundId)
print("Sound.Played Ereignis")
end)
sound.Paused:Connect(function(_soundId)
print("Sound.Paused Ereignis")
end)
sound.Resumed:Connect(function(_soundId)
print("Sound.Resumed Ereignis")
end)
sound.Stopped:Connect(function(_soundId)
print("Sound.Stopped Ereignis")
end)
sound:Play()
print("spielen", sound.Playing, sound.TimePosition) -- spielen true 0
task.wait(10)
sound:Pause()
print("pausieren", sound.Playing, sound.TimePosition) -- pausieren false 10
task.wait(3)
sound:Resume()
print("spielen", sound.Playing, sound.TimePosition) -- spielen true 10
task.wait(3)
sound:Stop()
print("stoppen", sound.Playing, sound.TimePosition) -- stoppen false 0
task.wait(3)
sound:Play()
print("spielen", sound.Playing, sound.TimePosition) -- spielen true 0Stopped
Parameter
Code-Beispiele
Sound-Funktionen
-- Erstelle einen Sound
local sound = Instance.new("Sound", game.Workspace)
sound.SoundId = "rbxassetid://9120386436"
if not sound.IsLoaded then
sound.Loaded:Wait()
end
-- Höre auf Ereignisse
sound.Played:Connect(function(_soundId)
print("Sound.Played Ereignis")
end)
sound.Paused:Connect(function(_soundId)
print("Sound.Paused Ereignis")
end)
sound.Resumed:Connect(function(_soundId)
print("Sound.Resumed Ereignis")
end)
sound.Stopped:Connect(function(_soundId)
print("Sound.Stopped Ereignis")
end)
sound:Play()
print("spielen", sound.Playing, sound.TimePosition) -- spielen true 0
task.wait(10)
sound:Pause()
print("pausieren", sound.Playing, sound.TimePosition) -- pausieren false 10
task.wait(3)
sound:Resume()
print("spielen", sound.Playing, sound.TimePosition) -- spielen true 10
task.wait(3)
sound:Stop()
print("stoppen", sound.Playing, sound.TimePosition) -- stoppen false 0
task.wait(3)
sound:Play()
print("spielen", sound.Playing, sound.TimePosition) -- spielen true 0