AudioPlayer
*เนื้อหานี้แปลโดยใช้ AI (เวอร์ชัน Beta) และอาจมีข้อผิดพลาด หากต้องการดูหน้านี้เป็นภาษาอังกฤษ ให้คลิกที่นี่
AudioPlayer ใช้เพื่อเล่นสื่อเสียง มันให้พินเดียว ออก ซึ่งสามารถเชื่อมต่อกับพินอื่นได้ผ่าน Wires
ตัวอย่างโค้ด
local audioPlayer: AudioPlayer = Instance.new("AudioPlayer")
audioPlayer.Parent = workspace
audioPlayer.AssetId = "rbxassetid://9112854440"
local deviceOutput = Instance.new("AudioDeviceOutput")
deviceOutput.Parent = workspace
local wire = Instance.new("Wire")
wire.Parent = workspace
wire.SourceInstance = audioPlayer
wire.TargetInstance = deviceOutput
audioPlayer:Play()
สรุป
คุณสมบัติ
สินทรัพย์ที่จะโหลดลงใน AudioPlayer
ควบคุมว่า Asset โหลดอัตโนมัติเมื่อได้รับการกำหนดแล้ว
ระบุว่าสิ่งนี้ AudioPlayer กําลังเล่นอยู่ในปัจจุบัน
บ่งบอกว่าสิ่งนี้ AudioPlayer ถูกโหลด บัฟเฟอร์ และพร้อมที่จะเล่น
ช่วงในวินาทีที่บ่งบอกถึงจุดเริ่มต้นและจุดสิ้นสุดของลูปที่ต้องการภายใน PlaybackRegion ของ AudioPlayer นี้
ควบคุมว่าลูปนี้ AudioPlayer จะควบคุม
ช่วงในวินาทีที่ระบุเวลาเริ่มต้นที่ต้องการ (อย่างน้อย) และเวลาหยุด (สูงสุด) ภายใน TimeLength
ควบคุมความเร็วที่สินทรัพย์จะเล่นได้เร็วเพียงใดซึ่งควบคุมความสูงของมัน
ระบุความยาวของสินทรัพย์ที่โหลดแล้ว
ติดตามตำแหน่งปัจจุบันของหัวเล่นภายในสินทรัพย์
ควบคุมระดับเสียงที่แอสเซทจะเล่นอย่างดัง
วิธีการ
ส่งคืนคอลเลกชันของ Wires ปักหมุด
เล่น AudioPlayer จากทุกที่ที่เป็น TimePosition
หยุด AudioPlayer ทุกที่ที่เป็น TimePosition
อีเวนต์
เกิดไฟไหม้เมื่อ AudioPlayer ได้สิ้นสุดการเล่นและหยุด
ไฟเมื่อวนลูป AudioPlayer ครั้ง
จะเกิดไฟไหม้เมื่ออินสแตนซ์อื่นถูกเชื่อมต่อกับหรือถูกแยกออกจาก AudioPlayer ผ่าน Wire
คุณสมบัติ
Asset
สินทรัพย์ที่จะโหลดลงใน AudioPlayerหาก AutoLoad เป็น true แอสเซทจะโหลดทันทีเมื่อมีการกำหนดค่าคุณสมบัตินี้เมื่อการโหลดสําเร็จแล้ว IsReady จะกลายเป็น true
AutoLoad
ควบคุมว่า Asset โหลดอัตโนมัติเมื่อได้รับการกำหนดแล้ว หาก false ทรัพยากรจะโหลดในครั้งแรกที่พยายามเล่น
IsPlaying
ระบุว่าสิ่งนี้ AudioPlayer กําลังเล่นอยู่ในปัจจุบันคุณสมบัตินี้เป็นแบบอ่านได้เท่านั้น แต่สามารถสร้างซ้ำได้เพื่อเล่นและหยุด AudioPlayer ในระหว่างการทำงาน ให้ใช้วิธี Play() และ Stop()
IsReady
บ่งบอกว่าสิ่งนี้ AudioPlayer ถูกโหลด บัฟเฟอร์ และพร้อมที่จะเล่นแม้ว่าไม่ธรรมดา AudioPlayers อาจมีสินทรัพย์ของพวกเขาถูกโหลดลงในระหว่างการทำงานหากมีแรงกดดันหน่วยความจำสุดขีด ในกรณีนี้ IsReady จะกลายเป็นเท็จ
LoopRegion
ช่วงในวินาทีที่บ่งบอกถึงจุดเริ่มต้นและจุดสิ้นสุดของลูปที่ต้องการภายใน PlaybackRegion ของ AudioPlayer นี้
หากขั้นต่ำ LoopRegion น้อยกว่า ใหญ่กว่า ขั้นต่ำ PlaybackRegion ลูปจะเริ่มจากขั้นต่ำ LoopRegion
หากขั้นต่ำ LoopRegion น้อยกว่า น้อยกว่า ขั้นต่ำสุดของ PlaybackRegion ลูปจะเริ่มจากขั้นต่ำ PlaybackRegion
หากขีดจํากัดสูงสุดของ LoopRegion มากที่สุดคือ มากกว่า ของ PlaybackRegion สูงสุด ลูปจะสิ้นสุดที่ PlaybackRegion สูงสุด
หากขีดจํากัดสูงสุดของ LoopRegion มากที่สุดคือ น้อยกว่า ของ PlaybackRegion สูงสุด ลูปจะสิ้นสุดที่ LoopRegion สูงสุดอย่างแน่นอน
หาก ขั้นต่ำ เท่ากับ สูงสุด ใช้คุณสมบัติ แทน
Looping
ควบคุมว่าลูปนี้ AudioPlayer เมื่อเกินจุดสิ้นสุดของมัน TimeLength หรือ LoopRegion หรือ PlaybackRegion
PlaybackRegion
ช่วงในวินาทีที่ระบุเวลาเริ่มต้นที่ต้องการ (อย่างน้อย) และเวลาหยุด (สูงสุด) ภายใน TimeLength
หากขั้นต่ำ PlaybackRegion น้อยกว่า มากกว่า 0, เสียงจะเริ่มเล่นตั้งแต่เวลา PlaybackRegion ต่ำสุด
หากขั้นต่ำ PlaybackRegion น้อยกว่า น้อยกว่า 0 เสียงจะเริ่มเล่นจาก 0
หากสูงสุดของ PlaybackRegion มากกว่า มากกว่า ของ TimeLength เสียงจะหยุดที่ TimeLength
หากสูงสุดของ PlaybackRegion มากกว่า น้อย กว่า TimeLength เสียงจะหยุดที่ PlaybackRegion สูงสุด
หาก PlaybackRegion ขั้นต่ำ เท่ากับ สูงสุด PlaybackRegion เสียงจะเล่นในทั้งหมด
PlaybackSpeed
ตัวคูณที่ควบคุมความเร็วที่สินทรัพย์จะเล่นได้เร็วเพียงใดโดยควบคุมเสียงที่รับรู้โดยตรง ช่วงตั้งแต่ 0 ถึง 20
Volume
ระดับระดับที่คูณกับสตรีมเสียงออก ควบคุมระดับเสียงที่แอสเซทจะเล่นอย่างดัง ช่วงตั้งแต่ 0 ถึง 3
วิธีการ
GetConnectedWires
ส่งคืนคอลเลกชันของ Wires ปักหมุดAudioPlayer ปักหมุด"เอาต์พุต" หนึ่งตัว
พารามิเตอร์
ส่งค่ากลับ
Play
เล่น AudioPlayer จากทุกที่ที่เป็น TimePosition ของมัน สําเนาจากเซิร์ฟเวอร์ไปยังไคลเอนต์
ส่งค่ากลับ
Stop
หยุด AudioPlayer ทุกที่ที่ TimePosition ของมันอยู่ สําเนาจากเซิร์ฟเวอร์ไปยังไคลเอนต์
ส่งค่ากลับ
GetWaveformAsync
พารามิเตอร์
ส่งค่ากลับ
อีเวนต์
Ended
ไฟไหม้หลังจากที่ AudioPlayer เสร็จสิ้นการเล่นและหยุดโปรดทราบว่าอีเวนต์นี้จะ ไม่ ยิงสําหรับเสียงด้วย Looped ตั้งค่าเป็น true เนื่องจากยังคงเล่นต่อไปเมื่อถึงจุดสิ้นสุดอีเวนต์นี้จะไม่ ไม่ได้ ปิด; สำหรับสิ่งนี้ให้ใช้ AudioPlayer:GetPropertyChangedSignal() ในคุณสมบัติ IsPlaying
อีเวนต์นี้มักใช้เพื่อทําลาย AudioPlayer เมื่อเสร็จสิ้นการเล่น
Looped
อีเวนต์ที่จะยิงหลังจากลูป AudioPlayer รอบสิ่งนี้เกิดขึ้นเมื่อเสียงถึงจุดสิ้นสุดของเนื้อหา (หรือจุดสิ้นสุดของ LoopRegion ถ้ามันใช้งานอยู่) และ Looping เป็น true
อีเวนต์นี้ไม่ได้ ไม่ ยิงหากเสียงถูกเล่นซ้ำโดยการเปลี่ยน TimePosition ของมัน
WiringChanged
อีเวนต์ที่จะยิงหลังจากที่ Wire เชื่อมต่อหรือถูกตัดการเชื่อมต่อและ Wire ตอนนี้หรือเคยเชื่อมต่อกับพินบน AudioPlayer อินสแตนซ์
พารามิเตอร์
ว่าตัวอย่างได้เชื่อมต่อหรือถูกตัดการเชื่อมต่อ
เข็มบน AudioPlayer ที่เป้าหมาย Wire
The Wire ระหว่าง AudioPlayer และตัวอย่างอื่น