Sound

แสดงที่เลิกใช้งานแล้ว

*เนื้อหานี้แปลโดยใช้ AI (เวอร์ชัน Beta) และอาจมีข้อผิดพลาด หากต้องการดูหน้านี้เป็นภาษาอังกฤษ ให้คลิกที่นี่

A Sound เป็นวัตถุที่ปล่อยเสียง

เสียง 2D และ 3D

เสียงที่วางอยู่ใน BasePart หรือ Attachment จะป

เสียงถูกพิจารณาว่าเป็น "ระดับโลก" หากไม่ได้เป็นลูกของ BasePart หรือ Attachment ในกรณีนี้เสียงจะเล่นด้วยเสียงเดียวกันทั่วทั้งสถานที่

ตัวอย่างโค้ด

Music Playing Part

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

-- create a sound
local sound = Instance.new("Sound", part)
sound.SoundId = "rbxassetid://9120386436" 
sound.EmitterSize = 5 -- decrease the emitter size (for earlier volume drop off)
sound.Looped = true
sound.Parent = part

local clickDetector = Instance.new("ClickDetector")
clickDetector.Parent = part

-- toggle the sound playing / not playing
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)

Sound in the Workspace

local sound = Instance.new("Sound")
sound.SoundId = "rbxassetid://9120386436"
sound.Looped = true
sound.Parent = workspace
sound:Play()

สรุป

คุณสมบัติ

ChannelCount:number
อ่านอย่างเดียว
ไม่ซ้ำ
ไม่สามารถเรียกดู
การรักษาความปลอดภัยของสคริปต์ Roblox
อ่านพร้อมๆ กัน
IsLoaded:bool
อ่านอย่างเดียว
ไม่ซ้ำ
อ่านพร้อมๆ กัน
สมบัตินี้จะเป็นจริงเมื่อ Sound ได้โหลดจากเซิร์ฟเวอร์ Roblox และพร้อมที่จะเล่น
IsPaused:bool
ซ่อนอยู่
อ่านอย่างเดียว
ไม่ซ้ำ
อ่านพร้อมๆ กัน
คุณสมบัตินี้จะกลับมาเป็นจริงเมื่อ Sound ไม่ได้เล่น
IsPlaying:bool
ซ่อนอยู่
อ่านอย่างเดียว
ไม่ซ้ำ
อ่านพร้อมๆ กัน
คุณสมบัตินี้จะกลับมาเป็นจริงเมื่อ Sound กำลังเล่น
LoopRegion:NumberRange
อ่านพร้อมๆ กัน
ระยะที่แสดงถึงต้นทางเริ่มต้นและต้นทางสิ้นสุดภายใน Sound.PlaybackRegion ในวินาที
Looped:bool
อ่านพร้อมๆ กัน
นี่กำหนดว่าจะให้ Sound ที่ซ้ำซากเมื่อมันเสร็จสิ้นเมื่อมันเล่น
PlayOnRemove:bool
อ่านพร้อมๆ กัน
เมื่อใช่จะเล่น Sound เมื่อถูกนำออกจากเกมโดยการรวมพ่อค้าของ Sound หรือหนึ่งหากมีกำเนิดมาจาก nil
PlaybackLoudness:number
อ่านอย่างเดียว
ไม่ซ้ำ
อ่านพร้อมๆ กัน
ตัวเลขระหว่าง 0 และ 1000 กำลังแสดงถึงความดังของ Sound ในขณะนี้
PlaybackRegion:NumberRange
อ่านพร้อมๆ กัน
ระยะที่ระบุเวลาเริ่มต้น (ต่ำสุด) และหยุด (สูงสุด) ภายใน Sound.TimeLength ในวินาที
PlaybackRegionsEnabled:bool
อ่านพร้อมๆ กัน
หาก จริง โปรไฟล์นี้ให้การเข้าถึง Sound ของคุณ กับ Sound.PlaybackRegion และ 2> Class.Sound.LoopRegion2> โปรไฟล์ ซึ่งสามารถควบคุมการเล่นได้มากขึ้น
PlaybackSpeed:number
ไม่ซ้ำ
อ่านพร้อมๆ กัน
กำหนดความเร็วที่ Sound จะเล่นด้วยค่าที่สูงขึ้นส่งผลให้เสียงเล่นเร็วขึ้นและด้วยความสูงขึ้น
Playing:bool
ไม่ซ้ำ
อ่านพร้อมๆ กัน
ระบุว่า Sound กำลังเล่นอยู่ในขณะนี้หรือไม่
RollOffMaxDistance:number
อ่านพร้อมๆ กัน
ระยะทางสูงสุดในสตั๊ดส์, ผู้ฟังของลูกค้าสามารถมาจาก Sound\s ต้นแบบและยังได้ยินมัน ใช้ได้กับเสียงที่มีความสัมพันธ์กับ Part หรือ Attachment (เส
RollOffMinDistance:number
อ่านพร้อมๆ กัน
ระยะระยะอ่อนสุดที่ต้องการสำหรับ 3D Sound (ลูกชายที่แท้จริงของ Class.BasePart หรือ Class.Attachment) จะเริ่มลดลง (ลดลงในปริมาณ)
RollOffMode:Enum.RollOffMode
อ่านพร้อมๆ กัน
ควบคุมวิธีการที่ความดังของ 3D Sound (พร้อมอยู่ในระดับของ BasePart หรือ Attachment ) ปฏิสัมพันธ์กับความไกลระหว่างผู้ฟังและความดังของเสียงของพ่อค้า
SoundGroup:SoundGroup
อ่านพร้อมๆ กัน
Class.SoundGroup ที่เกี่ยวข้องกับเสียงนี้ Sound จะผ่านไปยังเสียง เสียงและเอฟเฟ็กต์เสียงที่ประยุกต์ใช้กับเสียงนี้จะถูกนำไปใช้กับเสียง เสียงเท่านั้นในแต่ละกลุ่มเสียง
SoundId:ContentId
อ่านพร้อมๆ กัน
รายการนี้คือรหัสเนื้อหาของไฟล์เสียงที่เกี่ยวข้อง Sound อุปกรณ์ เมื่อเสียงถูกอัปโหลดไปยัง Roblox รหัสเนื้อหาสามารถพบได้ใน URL ของเสียงที่อัปโหลด
TimeLength:number
อ่านอย่างเดียว
ไม่ซ้ำ
อ่านพร้อมๆ กัน
ความยาวของ Sound ในวินาที หาก Sound ไม่โหลด ค่านี้จะเป็น 0
TimePosition:number
ไม่ซ้ำ
อ่านพร้อมๆ กัน
แสดงความคืบหน้าในวินาทีของ Sound สามารถเปลี่ยนแปลงเพื่อเคลื่อนย้ายตำแหน่งการเล่นของ Sound ได้ทั้งก่อนและระหว่างการเล่น
Volume:number
อ่านพร้อมๆ กัน
ระดับเสียงของ Sound สามารถปรับได้ระหว่าง 0 และ 10 ปกติจะตั้งค่าไว้ที่ 0.5 หมายเลข

ดูทั้งหมดที่รับทอดมาจาก Instance

ดูทั้งหมดที่รับทอดมาจาก Object

วิธีการ

Pause():void
ตั้งค่า Sound.Playing ให้เป็น false นี่จะหยุดการเล่นของ Sound หากเสียงกำลังเล่น เป็น Sound.TimePosition ไม่ได้รีเซ็ต เมื่อ 1> Class.Sound1> ได้ร
Play():void
เล่น Sound ตั้งค่า Sound.TimePosition ไปยังค่าสุดท้ายที่ติดตั้งโดย Script (หรือ 0 หากยังไม่ได้ติดตั้ง) แล้วตั้งค่า 1> Class.Sound.Playing1> เป็น true
Resume():void
รวบรวม Sound รีเซ็ต Sound.Playing ให้เป็นจริง ไม่เปลี่ยนแปลง Sound.TimePosition และดังนั้นจึงสามารถใช้เพื่อรีเซ็นการเล่นเสียงที่หยุดโดยการใช้
Stop():void
หยุด Sound ตั้งค่า Sound.Playing เป็น false แล้วตั้งค่า Sound.TimePosition เป็น 0

ดูทั้งหมดที่รับทอดมาจาก Instance

ดูทั้งหมดที่รับทอดมาจาก Object

อีเวนต์

DidLoop(soundId : string,numOfTimesLooped : number):RBXScriptSignal
เหตุการณ์ที่เกิดขึ้นเมื่อเวลา Sound ห่วงเหลี่ยมของวงจร ส่งคืน soundId และ numOfTimesLooped ให้คอนเทนต์ ID ของเสียงและจำนวนครั้งของการเล่นซ้ำ
Ended(soundId : string):RBXScriptSignal
เปิดเมื่อ Sound เสร็จสิ้นการเล่นและหยุด
Loaded(soundId : string):RBXScriptSignal
เปิดเมื่อ Sound โหลดแล้ว
Paused(soundId : string):RBXScriptSignal
เปิดให้เมื่อ Sound ถูกหยุดใช้งานโดย Sound:Pause()
Played(soundId : string):RBXScriptSignal
เปิดให้เมื่อ Sound ถูกเล่นโดยใช้ฟังก์ชัน Sound:Play()
Resumed(soundId : string):RBXScriptSignal
เปิดให้ใช้งานเมื่อ Sound ถูกเริ่มขึ้นใหม่โดยใช้ Sound:Resume()
Stopped(soundId : string):RBXScriptSignal
เปิดให้บริการเมื่อ Sound ถูกหยุดทำงานเนื่องจากการใช้งาน Sound:Stop()

ดูทั้งหมดที่รับทอดมาจาก Instance

ดูทั้งหมดที่รับทอดมาจาก Object

คุณสมบัติ

ChannelCount

number

อ่านอย่างเดียว

ไม่ซ้ำ

ไม่สามารถเรียกดู

การรักษาความปลอดภัยของสคริปต์ Roblox

อ่านพร้อมๆ กัน

IsLoaded

bool

อ่านอย่างเดียว

ไม่ซ้ำ

อ่านพร้อมๆ กัน

สมบัตินี้จะเป็นจริงเมื่อ Sound ได้โหลดจากเซิร์ฟเวอร์ Roblox และพร้อมที่จะเล่น

ใน Roblox ไฟล์เสียงไม่ได้ถูกเก็บไว้ในเกมเอง แต่จะถูกเก็บไว้บนเซิร์ฟเวอร์ Roblox และอ้างอิงโดยคุณสมบัติ Sound.SoundId นี้ ซึ่งหมายความว่าพวกเขา

ผู้พัฒนาสามารถใช้ Sound.IsLoaded สมบัติสมบัติและ Sound.Loaded อีเวนต์หากต้องการตรวจสอบว่ามีเสียงโหลดก่อนเล่น

ตัวอย่างโค้ด

Load Sound

local sound = script.Parent.Sound

if not sound.IsLoaded then
	sound.Loaded:Wait()
end

print("The sound has loaded!")

IsPaused

bool

ซ่อนอยู่

อ่านอย่างเดียว

ไม่ซ้ำ

อ่านพร้อมๆ กัน

สมบัติสมุดนี้จะไม่เป็นจริงเมื่อ Sound ไม่ได้เล่น หมายเหตุว่าสมบัติสมุดนี้จะไม่เป็นจริงเมื่อเสียงถูกหยุดใช้งานโดยใช้การใช้งาน Sound:Pause()

คุณสมบัตินี้จะเป็นจริงเฉพาะเมื่อ Sound.IsPlaying เป็นปลอม

As IsPaused ไม่สามารถใช้เพื่อหยุดเสียงได้, Sound:Stop() และ Sound:Pause() ควรใช้แทน.

ตัวอย่างโค้ด

Sound IsPlaying and 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) -- true, false

task.wait(2)
sound:Pause()
print(sound.IsPlaying, sound.IsPaused) -- false, true

task.wait(2)
sound:Play()
print(sound.IsPlaying, sound.IsPaused) -- true, false

task.wait(2)
sound:Stop()
print(sound.IsPlaying, sound.IsPaused) -- false, true

IsPlaying

bool

ซ่อนอยู่

อ่านอย่างเดียว

ไม่ซ้ำ

อ่านพร้อมๆ กัน

คุณสมบัตินี้จะกลับมาเป็นจริงเมื่อ Sound กำลังเล่น

คุณสมบัตินี้สามารถเป็นจริงได้เมื่อ Sound.IsPaused เป็นปลอม

เนื่องจาก As IsPlaying อ่านเท่านั้นจึงไม่สามารถใช้เพื่อเล่นเสียงได้, Sound:Play() ควรใช้แทน

ตัวอย่างโค้ด

Sound IsPlaying and 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) -- true, false

task.wait(2)
sound:Pause()
print(sound.IsPlaying, sound.IsPaused) -- false, true

task.wait(2)
sound:Play()
print(sound.IsPlaying, sound.IsPaused) -- true, false

task.wait(2)
sound:Stop()
print(sound.IsPlaying, sound.IsPaused) -- false, true

LoopRegion

NumberRange

อ่านพร้อมๆ กัน

ระยะที่แสดงตำแหน่งเริ่มต้นและสิ้นสุดของเสียงใน Sound.PlaybackRegion ในเวลาวินาที

หาก LoopRegion.Min > PlaybackRegion.Min วงจรเริ่มต้นจาก LoopRegion.Min
หาก LoopRegion.Min < PlaybackRegion.Min , วงจรจะเริ่มตั้งแต่ PlaybackRegion.Min
หาก LoopRegion.Max > PlaybackRegion.Max โครงร่างจะเริ่มต้นที่ PlaybackRegion.Max
หาก LoopRegion.Max < PlaybackRegion.Max วงจรจะเริ่มต้นที่ ใช่เวลานั้น
หาก LoopRegion.Min เป็น LoopRegion.Max สิ่งนี้จะใช้ Sound แทน

Looped

bool

อ่านพร้อมๆ กัน

นี่กำหนดว่าจะให้ Sound ที่ซ้ำซากเมื่อมันเสร็จสิ้นเมื่อมันเล่น

เสียงที่ซ้ำซากเหมาะสำหรับการใช้งานที่หลากหลาย รวมถึงดนตรีและเสียงพื้นหลัง เหตุการณ์ Sound.DidLoop สามารถใช้เพื่อติดตามจำนวนครั้งที่เสียงเหมือนซ้ำกัน

ตัวอย่างโค้ด

Sound Looping

local Players = game:GetService("Players")

local function onPlayerAdded(player)
	local function onCharacterAdded(character)
		-- wait for the head to be added
		local head = character:WaitForChild("Head")

		local sound = Instance.new("Sound")
		sound.Name = "TestSound"
		sound.SoundId = "rbxasset://sounds/uuhhh.mp3" -- oof
		sound.Parent = head

		sound.Looped = true

		sound.DidLoop:Connect(function(_soundId, numOfTimesLooped)
			print("oof! " .. tostring(numOfTimesLooped))
		end)

		sound:Play()
	end

	player.CharacterAdded:Connect(onCharacterAdded)
end

Players.PlayerAdded:Connect(onPlayerAdded)

Loop a Number of Times

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
				-- disconnect the connection
				connection:Disconnect()
				-- stop the sound
				sound:Stop()
			end
		end)
		sound:Play()
	end
end

local sound = Instance.new("Sound")
sound.SoundId = "rbxassetid://0"

loopNTimes(sound, 5)

PlayOnRemove

bool

อ่านพร้อมๆ กัน

เมื่อใช่, Sound จะเล่นเมื่อถูกนำออกจากเกม

หมายเหตุว่าเสียงจะเล่นเมื่อค่า Instance.Parent หรือหนึ่งในบรรพบุรุษของ Sound ตั้งค่าไว้เป็นศูนย์ นี่หมายถึงทั้งหมดของสิ่งต่อไปนี้จะทำให้เสี

เสียง: ทำลายเสียง.พ่อ = ไม่มีเสียงพ่อ.พ่อ = ไม่มีเสียงพ่อ

ตัวอย่างโค้ด

Sound PlayOnRemove

local sound = Instance.new("Sound")
sound.Name = "TestSound"
sound.SoundId = "rbxasset://sounds/uuhhh.mp3" -- oof
sound.Parent = workspace

sound.PlayOnRemove = true

task.wait(3)

sound:Destroy()

PlaybackLoudness

number

อ่านอย่างเดียว

ไม่ซ้ำ

อ่านพร้อมๆ กัน

ตัวเลขระหว่าง 0 และ 1000 กำลังแสดงถึงความดังของ Sound ในขณะนี้

อ่านแล้วดังนั้นสำหรับเสียงส่วนใหญ่จะปรับแก้อยู่เสมอ เนื่องจากสิ่งนี้จึงสามารถปรากฏในหน้า

ตัวอย่างโค้ด

Volume Amplitude Bar

-- to be placed in StarterPlayer > StarterPlayerScripts

local Players = game:GetService("Players")

-- wait for local player PlayerGui
local LocalPlayer = Players.LocalPlayer
local playerGui = LocalPlayer:WaitForChild("PlayerGui")

-- create a ScreenGui
local screenGui = Instance.new("ScreenGui")
screenGui.Parent = playerGui

-- create a holder for our bar
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

-- create a bar
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

-- create a sound
local sound = Instance.new("Sound")
sound.SoundId = "rbxassetid://9120386436"
sound.Looped = true
sound.Parent = screenGui
sound:Play()

-- define a max loudness
local maxLoudness = 30

-- animate the amplitude bar
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

NumberRange

อ่านพร้อมๆ กัน

ระยะที่ระบุเวลาเริ่มต้น (ต่ำสุด) และหยุด (สูงสุด) ภายใน Sound.TimeLength ในวินาที

หาก PlaybackRegion.Min > 0, เสียงจะเริ่มเล่นจากเวลา PlaybackRegion.Min
หาก PlaybackRegion.Min < 0 เสียงจะเริ่มเล่นจาก 0
หาก PlaybackRegion.Max > Sound.TimeLength เสียงจะหยุดที่ Sound.TimeLength
หาก PlaybackRegion.Max < Sound.TimeLength จะหยุดเสียงที่ ถูกต้อง ในเวลานั้น
หาก PlaybackRegion.Min <> PlaybackRegion.Max ไม่ได้ใช้งานอยู่

PlaybackRegionsEnabled

bool

อ่านพร้อมๆ กัน

หาก จริง โปรไฟล์นี้ให้การเข้าถึง Sound ของคุณ กับ Sound.PlaybackRegion และ 2> Class.Sound.LoopRegion2> โปรไฟล์ ซึ่งสามารถควบคุมการเล่นได้มากขึ้น

PlaybackSpeed

number

ไม่ซ้ำ

อ่านพร้อมๆ กัน

กำหนดความเร็วที่ Sound จะเล่น ยิ่งมีค่ามากเท่าไหร่ ย้อนกลับ

เช่น มูลค่า 2 จะทำให้ Sound เล่นเร็วขึ้นสองเท่า ในขณะที่มูลค่า 0.5 จะทำให้เสียงใช้เวลา Sound.TimeLength (ในวินาที) เพื่อเสร็จสิ้น

หมายเหตุว่าเพิ่มความเร็วในการเล่นของเสียงจะทำให้เล่นที่ความถี่สูง

ตัวอย่างโค้ด

Sound PlaybackSpeed

local sound = Instance.new("Sound")
sound.SoundId = "rbxassetid://9120386436"
sound.Looped = true
sound.Parent = workspace

sound:Play()
task.wait(10)
sound.PlaybackSpeed = 3 -- 3x faster
task.wait(5)
sound.PlaybackSpeed = 0.5 -- 2x slower
task.wait(5)
sound.PlaybackSpeed = 1 -- default

Playing

bool

ไม่ซ้ำ

อ่านพร้อมๆ กัน

ระบุว่า Sound กำลังเล่นอยู่หรือไม่ สิ่งนี้สามารถเปิด/ปิดได้ และค่านี้จะเคลื่อนที่ตลอดไป

ในเวทีเอเชียนั้น Sounds ไม่สามารถเล่นได้เนื่องจากเวลาถูกหยุด การตั้งค่า Sound.Playing ให้เป็น true ในโหมดแก้ไขไม่ได้ทำ

คุณสมบัตินี้ไม่ควรสับสนกับ Sound.IsPlaying ซึ่งเป็นคุณสมบัติที่อ่านเท่านั้น การเล่นสามารถตั้งค่าไปยัง true หรือ false เพื่อเริ่มหรือหยุดการเล่นเสียง

หมายเหตุว่าเมื่อการเล่นถูกตั้งค่าเป็น false คุณสมบัติของเสียง Sound.TimePosition จะไม่รีเซ็ต ซึ่งหมายความว่าเมื่อการเล่นถูกตั้งค่าเป็น true อีกครั้ง

ตัวอย่างโค้ด

Sound Playing

local sound = Instance.new("Sound")
sound.SoundId = "rbxassetid://9120386436"
sound.Looped = true
sound.Parent = workspace

print("playing sound")
sound.Playing = true

task.wait(10)

print("stopping sound")
sound.Playing = false

task.wait(5)

sound.Playing = true
local timePosition = sound.TimePosition
print("resumed at time position: " .. tostring(timePosition)) -- c. 10 seconds

RollOffMaxDistance

number

อ่านพร้อมๆ กัน

ระยะทางสูงสุดในสตั๊ดส์ที่ผู้ฟังของลูกค้าสามารถมาจาก Sound ต้นแบบและยังได้ยินมัน ใช้ได้กับเสียงที่เกี่ยวข้องกับ Part หรือ Attachment (เสียง 3D)

วิธีการที่ RollOffMaxDistance ส่งผลต่อความเปลือยของเสียง (วิธีที่มันจะจางลง) ขึ้นอยู่กับคุณสมบัติ Sound.RollOffMode เ

เมื่อ RollOffMode ติดตั้งไว้ที่โมเดลระยะทางชนิดเส้นเส้น (Linear or LinearSquared) จะมีเสียงลดลงระหว่าง Sound.EmitterSize และ MaxDistance (ด้วยปริมาณการเล่นที่ถึงขีดจำกัดที่ RollOffMaxDistance) นี่เป็นเรื่

RollOffMinDistance

number

อ่านพร้อมๆ กัน

ระยะระยะอ่อนสุดที่ต้องการสำหรับ 3D Sound (ลูกชายที่แท้จริงของ Class.BasePart หรือ Class.Attachment) จะเริ่มลดลง (ลดลงในปริมาณ)

เสียงที่เกี่ยวข้องกับ BasePart หรือ Attachment ที่เป็นลูกหลานของ Workspace จะถ

วิธีที่ Sound จะลดลง (หายไป) หลังจากระยะเวลาระหว่างผู้ฟังและเสียงเกินขีดจำกัดที่กำหนดโดย RollOffMinDistance โดย RollOffMode

RollOffMode

Enum.RollOffMode

อ่านพร้อมๆ กัน

สมบัตินี้กำหนดวิธีการที่ 3D Sounds ลดลง (หายไป) เมื่อระยะระหว่างผู้ฟังและพ่อของเสียงเพิ่มขึ้น สมบัตินี้สามารถตั้งค่าได้เป็นหนึ่งในค่าของ Enum.RollOffMode เม

ต่อไปนี้จะตั้งค่า RollOffMode เป็น Linear:


sound.RollOffMode = Enum.RollOffMode.Linear

โหมดที่แตกต่างกัน

ตัวเลือกต่อไปนี้สามารถใช้ได้:


<tbody>
  <tr>
    <td>ย้อนกลับ</td>
    <td>ระดับเสียงลดลงจาก <code>Sound/RollOffMinDistance</code> ในวิธีที่เป็นบวก</td>
  </tr>

  <tr>
    <td>InverseTapered และ</td>
    <td>รุ่นไฮบริด ติดตามแนวโน้มแบบกลับขวาเมื่อใกล้ <code>รอลเอาท์มินเดอร์ดิสทรัคท์</code> และแนวโน้มแบบเส้นสายเมื่อใกล้ <code>โซน/รอลเอาท์แม็กซ์ดิสทรัคท์</code></td>
  </tr>

  <tr>
    <td>เชิงเส้น</td>
    <td>ระดับเสียงลดลงระหว่าง <code>RollOffMinDistance</code> และ <code>Sound/RollOffMaxDistance</code> ด้วยความสัมพันธ์เชิงเส้น</td>
  </tr>

  <tr>
    <td>สามเหลี่ยม</td>
    <td>ระดับเสียงลดลงระหว่าง <code>RollOffMinDistance</code> และ <code>Sound/RollOffMaxDistance</code> ด้วยความสัมพันธ์เชิงเส้น</td>
  </tr>
</tbody>

โหมด	คำอธิบาย

การปรับปรุงค่าความเห็นทางไปยัง Inverse vs Linear Distance Attenuation

โดยปกติเสียงจะตั้งค่าให้ใช้การลดความจริงของเสียง (Enum.RollOffMode.Inverse) ซึ่งสะท้อนวิธีที่เสียงจะลดในโลกแห่งควา

RollOffMaxDistance จะไม่ส่งผลกระทบต่อการปรับแต่งภายใต้แนวคิดเชิงกลับกัน แต่จะทำให้เสียงหยุดสมบูรณ์เมื่อระยะนี้ถึง สิ่งนี้อาจเป็นเรื่องที่น่าประหลาดใจเมื่อใช้ค่าต่ำสุดสำหรับระยะสูงสุด

ระยะทางที่เป็นเส้นทางที่เป็นเส้นทางเชิงเส้น ระยะทางที่เป็นเส้นทางเชิงเส้นจะทำงานได้อย่างแตกต่างกัน ในร

SoundGroup

อ่านพร้อมๆ กัน

Class.SoundGroup ที่เกี่ยวข้องกับ Sound นี้ SoundGroup.Volume และ 1>Class.SoundGroup.Effects1> ที่ใช้กับเสียงกลุ่มนี้จะผ่านไปยังเสียง เสียงสามารถอยู่ในกลุ่มเสียง

SoundGroups ใช้เพื่อจัดการปริมาณและเอฟเฟ็กต์ของ Sounds หลายรายการในครั้งเดียว สิ่งหนึ่ง Sound ได้รับการเพิ่มในสิ่งที่เป็น 0>

ตัวอย่างโค้ด

SoundGroups

local SoundService = game:GetService("SoundService")

-- create a sound group
local soundGroup = Instance.new("SoundGroup")
soundGroup.Parent = SoundService

-- create a sound
local sound = Instance.new("Sound")
sound.SoundId = "rbxassetid://9120386436"
sound.Looped = true
sound.PlaybackSpeed = 2
sound.SoundGroup = soundGroup
sound.Parent = workspace

-- play the sound
sound:Play()

task.wait(10)

-- change the volume
soundGroup.Volume = 0.1

task.wait(3)

-- return the volume
soundGroup.Volume = 0.5

task.wait(4)

-- add a sound effect
local reverb = Instance.new("ReverbSoundEffect")
reverb.Parent = soundGroup

SoundId

ContentId

อ่านพร้อมๆ กัน

รายการนี้คือรหัสเนื้อหาของไฟล์เสียงที่เกี่ยวข้อง Sound อุปกรณ์ เมื่อเสียงถูกอัปโหลดไปยัง Roblox รหัสเนื้อหาสามารถพบได้ใน URL ของเสียงที่อัปโหลด

มีความสำคัญที่จะจำ URL ไม่ใช่เหมือนรหัสเนื้อหา มันจะทำงานเมื่อวางโดยตรงในโครงสร้าง SoundId ของ Sound ใน Roblox Studio เนื่องจาก Studio จะอัปเดตอัตโนมัติ


"https://www.roblox.com/catalog/9120386436" -- ที่อยู่ URL ของเว็บไซต์ (จะไม่ทำงาน)
"http://www.roblox.com/asset/?id=9120386436" -- รหัสเนื้อหา (จะทำงาน)
"rbxassetid://9120386436" -- Content ID (alternative version, will work)

ตัวอย่างโค้ด

Sound in the Workspace

local sound = Instance.new("Sound")
sound.SoundId = "rbxassetid://9120386436"
sound.Looped = true
sound.Parent = workspace
sound:Play()

TimeLength

number

อ่านอย่างเดียว

ไม่ซ้ำ

อ่านพร้อมๆ กัน

ความยาวของ Sound ในวินาที หาก Sound ไม่โหลด ค่านี้จะเป็น 0

สมบัตินี้มักใช้ร่วมกับ Sound.PlaybackSpeed เพื่อปรับความเร็วของเสียงให้มีระยะเวลาที่ยืนยาว (ดูตัวอย่าง) เมื่อ Sound.PlaybackSpeed เท่ากับ 1 เสียงจะใช้เวลาในการเสร็

ตัวอย่างโค้ด

Play a Sound for a Specific Duration

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

number

ไม่ซ้ำ

อ่านพร้อมๆ กัน

แสดงความคืบหน้าในวินาทีของ Sound สามารถเปลี่ยนแปลงเพื่อเปลี่ยนตำแหน่งการเล่นของเสียง หากเสียงกำลังเล่นอยู่แล้วก็จะสแน็ปไปที่ตำแหน่งที่กำหนด หา

เมื่อ Sound เปิดใช้งานได้เป็นเวลานาที Sound.PlaybackSpeed จะเพิ่มขึ้นในอัตรา Sound.TimeLength ต่อวินาที เม

หมายเหตุว่าการตั้งค่า TimePosition ให้เป็นค่ามากกว่าความยาวในแทร็กที่เป็นลูปจะไม่ทำให้มันหุ้มรอบ

หาก newPosition ใหญ่กว่า sound.TimeLength เสียงใหม่จะเป็นเสียงสิ้นสุดของเสียง.TimePosition = newPosition

การตั้งตำแหน่งเวลาให้เป็นค่าน้อยกว่า zero ในขณะนี้ไม่ส่งผลต่อการเล่น แต่พฤติกรรมนี้ไม่ควรเชื่อถือได้

ตัวอย่างโค้ด

Sound TimePosition

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

number

อ่านพร้อมๆ กัน

ระดับเสียงของ Sound สามารถตั้งได้ระหว่าง 0 และ 10 ตั้งค่าเริ่มต้นได้ที่ 0.5

หมุดหมายเหตุว่าหาก Sound เป็นสมาชิกของ SoundGroup จะมีปริมาณการเล่นของมัน (แต่ไม่ใช่ค่า Volume

ตัวอย่างโค้ด

Sound Volume

local sound = Instance.new("Sound")
sound.SoundId = "rbxassetid://9120386436"
sound.Looped = true
sound.PlaybackSpeed = 2
sound.Parent = workspace

sound.Volume = 2

sound:Play()

task.wait(7)

sound.Volume = 0.2

ดูทั้งหมดที่รับทอดมาจาก Instance

ดูทั้งหมดที่รับทอดมาจาก Object

วิธีการ

Pause

void

ตั้ง Sound.Playing เป็น false สิ่งนี้ระงับการเล่นของ Sound หากเสียงกำลังเล่น ไม่เหมือน Sound:Stop() มันไม่รีเซ็ต 1>

ผลกระทบของเสียงที่แตกต่างกันใน Sound.Playing และ Sound.TimePosition จะปรากฏด้านล่าง


<tbody>
  <tr>
    <td>เสียง:เล่น()</td>
    <td>ใช่</td>
    <td>ค่าสุดท้ายที่ติดตั้งใน Lua (ค่าเริ่มต้น 0)</td>
  </tr>

  <tr>
    <td>เสียง:Pause()</td>
    <td>ปลอม</td>
    <td>:-</td>
  </tr>

  <tr>
    <td>เสียง: กลับเข้ามา()</td>
    <td>ใช่</td>
    <td>:-</td>
  </tr>

  <tr>
    <td>เสียง:Stop()</td>
    <td>ปลอม</td>
    <td>0</td>
  </tr>
</tbody>

ฟังก์ชัน	เสียง.เล่น	ตำแหน่งเวลาเสียง

ส่งค่ากลับ

void

ตัวอย่างโค้ด

Sound Functions

-- create a sound
local sound = Instance.new("Sound", game.Workspace)
sound.SoundId = "rbxassetid://9120386436"

if not sound.IsLoaded then
	sound.Loaded:Wait()
end

-- listen for events
sound.Played:Connect(function(_soundId)
	print("Sound.Played event")
end)

sound.Paused:Connect(function(_soundId)
	print("Sound.Paused event")
end)

sound.Resumed:Connect(function(_soundId)
	print("Sound.Resumed event")
end)

sound.Stopped:Connect(function(_soundId)
	print("Sound.Stopped event")
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

void

เล่น Sound ตั้งค่า Sound.TimePosition ไปยังค่าสุดท้ายที่ติดตั้งโดย Script (หรือ 0 หากยังไม่ได้ติดตั้ง) แล้วตั้งค่า 1> Class.Sound.Playing1> เป็น true

ผลกระทบของคุณสมบัติต่างๆ ของ Sound ฟังก์ชั่น และ Sound.Playing และ Sound.TimePosition ด้านล่าง


<tbody>
  <tr>
    <td>เสียง:เล่น()</td>
    <td>ใช่</td>
    <td>ค่าสุดท้ายที่ติดตั้งใน Lua (ค่าเริ่มต้น 0)</td>
  </tr>

  <tr>
    <td>เสียง:Pause()</td>
    <td>ปลอม</td>
    <td>:-</td>
  </tr>

  <tr>
    <td>เสียง: กลับเข้ามา()</td>
    <td>ใช่</td>
    <td>:-</td>
  </tr>

  <tr>
    <td>เสียง:Stop()</td>
    <td>ปลอม</td>
    <td>0</td>
  </tr>
</tbody>

ฟังก์ชัน	เสียง.เล่น	ตำแหน่งเวลาเสียง

ส่งค่ากลับ

void

ตัวอย่างโค้ด

Sound Functions

-- create a sound
local sound = Instance.new("Sound", game.Workspace)
sound.SoundId = "rbxassetid://9120386436"

if not sound.IsLoaded then
	sound.Loaded:Wait()
end

-- listen for events
sound.Played:Connect(function(_soundId)
	print("Sound.Played event")
end)

sound.Paused:Connect(function(_soundId)
	print("Sound.Paused event")
end)

sound.Resumed:Connect(function(_soundId)
	print("Sound.Resumed event")
end)

sound.Stopped:Connect(function(_soundId)
	print("Sound.Stopped event")
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

Resume

void

รวบรวม Sound รีเซ็ต Sound.Playing ให้เป็นจริง ไม่เปลี่ยนแปลง Sound.TimePosition และดังนั้นจึงสามารถใช้เพื่อรีเซ็นการเล่นเสียงที่หยุดโดยการใช้

ผลกระทบของระบบเสียงที่แตกต่างกันใน Sound.Playing และ Sound.TimePosition ปรากฏด้านล่าง


<tbody>
  <tr>
    <td>เสียง:เล่น()</td>
    <td>ใช่</td>
    <td>ค่าสุดท้ายที่ติดตั้งใน Lua (ค่าเริ่มต้น 0)</td>
  </tr>

  <tr>
    <td>เสียง:Pause()</td>
    <td>ปลอม</td>
    <td>:-</td>
  </tr>

  <tr>
    <td>เสียง: กลับเข้ามา()</td>
    <td>ใช่</td>
    <td>:-</td>
  </tr>

  <tr>
    <td>เสียง:Stop()</td>
    <td>ปลอม</td>
    <td>0</td>
  </tr>
</tbody>

ฟังก์ชัน	เสียง.เล่น	ตำแหน่งเวลาเสียง

ส่งค่ากลับ

void

ตัวอย่างโค้ด

Sound Functions

-- create a sound
local sound = Instance.new("Sound", game.Workspace)
sound.SoundId = "rbxassetid://9120386436"

if not sound.IsLoaded then
	sound.Loaded:Wait()
end

-- listen for events
sound.Played:Connect(function(_soundId)
	print("Sound.Played event")
end)

sound.Paused:Connect(function(_soundId)
	print("Sound.Paused event")
end)

sound.Resumed:Connect(function(_soundId)
	print("Sound.Resumed event")
end)

sound.Stopped:Connect(function(_soundId)
	print("Sound.Stopped event")
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

void

หยุด Sound ตั้งค่า Sound.Playing เป็น false แล้วตั้งค่า Sound.TimePosition เป็น 0

ผลกระทบของระบบเสียงที่แตกต่างกันใน Sound.Playing และ Sound.TimePosition ปรากฏด้านล่าง


<tbody>
  <tr>
    <td>เสียง:เล่น()</td>
    <td>ใช่</td>
    <td>ค่าสุดท้ายที่ติดตั้งใน Lua (ค่าเริ่มต้น 0)</td>
  </tr>

  <tr>
    <td>เสียง:Pause()</td>
    <td>ปลอม</td>
    <td>:-</td>
  </tr>

  <tr>
    <td>เสียง: กลับเข้ามา()</td>
    <td>ใช่</td>
    <td>:-</td>
  </tr>

  <tr>
    <td>เสียง:Stop()</td>
    <td>ปลอม</td>
    <td>0</td>
  </tr>
</tbody>

ฟังก์ชัน	เสียง.เล่น	ตำแหน่งเวลาเสียง

ส่งค่ากลับ

void

ตัวอย่างโค้ด

Sound Functions

-- create a sound
local sound = Instance.new("Sound", game.Workspace)
sound.SoundId = "rbxassetid://9120386436"

if not sound.IsLoaded then
	sound.Loaded:Wait()
end

-- listen for events
sound.Played:Connect(function(_soundId)
	print("Sound.Played event")
end)

sound.Paused:Connect(function(_soundId)
	print("Sound.Paused event")
end)

sound.Resumed:Connect(function(_soundId)
	print("Sound.Resumed event")
end)

sound.Stopped:Connect(function(_soundId)
	print("Sound.Stopped event")
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

ดูทั้งหมดที่รับทอดมาจาก Instance

ดูทั้งหมดที่รับทอดมาจาก Object

อีเวนต์

DidLoop

เหตุการณ์ที่เกิดขึ้นเมื่อเวลา Sound ห่วงเหลี่ยมของวงจร ส่งคืน soundId และ numOfTimesLooped ให้คอนเทนต์ ID ของเสียงและจำนวนครั้งของการเล่นซ้ำ

เมื่อ Sound ถูกหยุดวงจรจะถูกรีเซ็ตหมายถึงการตั้งค่าต่อไปจะกลับมา 1 สำหรับ numOfTimesLooped

พารามิเตอร์

soundId: string

Class.Sound.SoundId ของ Sound ที่เปิดเครื่องเสียง

numOfTimesLooped: number

จำนวนครั้งที่ Sound เคยเป็นลูป

ตัวอย่างโค้ด

Loop a Number of Times

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
				-- disconnect the connection
				connection:Disconnect()
				-- stop the sound
				sound:Stop()
			end
		end)
		sound:Play()
	end
end

local sound = Instance.new("Sound")
sound.SoundId = "rbxassetid://0"

loopNTimes(sound, 5)

Ended

เปิดเมื่อ Sound เสร็จสิ้นการเล่นและหยุด หมายเหตุว่าเหตุการณ์นี้จะไม่ได้เปิดสำหรับเสียงที่มี Sound.Looped ตั้งค่าเป็น true เมื่อพวกเขาเล่นต่อไปจนกว่าจะถึงจุดสิ้นสุด

เหตุการณ์นี้มักใช้เพื่อทำลายเสียงเมื่อมันเสร็จสิ้นการเล่น


sound:Play()
sound.Ended:Wait()
sound:Destroy()

Class.Sound.SoundId ของ Sound ที่หยุด

ตัวอย่างโค้ด

Sound Functions

-- create a sound
local sound = Instance.new("Sound", game.Workspace)
sound.SoundId = "rbxassetid://9120386436"

if not sound.IsLoaded then
	sound.Loaded:Wait()
end

-- listen for events
sound.Played:Connect(function(_soundId)
	print("Sound.Played event")
end)

sound.Paused:Connect(function(_soundId)
	print("Sound.Paused event")
end)

sound.Resumed:Connect(function(_soundId)
	print("Sound.Resumed event")
end)

sound.Stopped:Connect(function(_soundId)
	print("Sound.Stopped event")
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

ดูทั้งหมดที่รับทอดมาจาก Instance

ดูทั้งหมดที่รับทอดมาจาก Object