AudioPlayer

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

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

AudioPlayer ใช้เพื่อเล่นสื่อเสียง มันให้พินเดียว ออก ซึ่งสามารถเชื่อมต่อกับพินอื่นได้ผ่าน Wires

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

Outputting Audio to Device

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()

สรุป

คุณสมบัติ

  • Asset:ContentId
    อ่านพร้อมๆ กัน

    สินทรัพย์ที่จะโหลดลงใน AudioPlayer

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

    ควบคุมว่า Asset โหลดอัตโนมัติเมื่อได้รับการกำหนดแล้ว

  • การรักษาความปลอดภัยของ Roblox
    อ่านพร้อมๆ กัน

    ระบุว่าสิ่งนี้ AudioPlayer กําลังเล่นอยู่ในปัจจุบัน

  • อ่านอย่างเดียว
    ไม่ซ้ำ
    อ่านพร้อมๆ กัน

    บ่งบอกว่าสิ่งนี้ AudioPlayer ถูกโหลด บัฟเฟอร์ และพร้อมที่จะเล่น

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

    ช่วงในวินาทีที่บ่งบอกถึงจุดเริ่มต้นและจุดสิ้นสุดของลูปที่ต้องการภายใน PlaybackRegion ของ AudioPlayer นี้

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

    ควบคุมว่าลูปนี้ AudioPlayer จะควบคุม

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

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

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

    ควบคุมความเร็วที่สินทรัพย์จะเล่นได้เร็วเพียงใดซึ่งควบคุมความสูงของมัน

  • อ่านอย่างเดียว
    ไม่ซ้ำ
    อ่านพร้อมๆ กัน

    ระบุความยาวของสินทรัพย์ที่โหลดแล้ว

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

    ติดตามตำแหน่งปัจจุบันของหัวเล่นภายในสินทรัพย์

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

    ควบคุมระดับเสียงที่แอสเซทจะเล่นอย่างดัง

วิธีการ

อีเวนต์

คุณสมบัติ

Asset

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

สินทรัพย์ที่จะโหลดลงใน AudioPlayerหาก AutoLoad เป็น true แอสเซทจะโหลดทันทีเมื่อมีการกำหนดค่าคุณสมบัตินี้เมื่อการโหลดสําเร็จแล้ว IsReady จะกลายเป็น true

AutoLoad

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

ควบคุมว่า Asset โหลดอัตโนมัติเมื่อได้รับการกำหนดแล้ว หาก false ทรัพยากรจะโหลดในครั้งแรกที่พยายามเล่น

IsPlaying

การรักษาความปลอดภัยของ Roblox
อ่านพร้อมๆ กัน

ระบุว่าสิ่งนี้ 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

TimeLength

อ่านอย่างเดียว
ไม่ซ้ำ
อ่านพร้อมๆ กัน

ระบุระยะเวลาของการโหลด Asset ในวินาที

TimePosition

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

ติดตามและควบคุมตำแหน่งปัจจุบันของหัวเล่นภายใน Asset ในเวลาไม่กี่วินาที

Volume

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

ระดับระดับที่คูณกับสตรีมเสียงออก ควบคุมระดับเสียงที่แอสเซทจะเล่นอย่างดัง ช่วงตั้งแต่ 0 ถึง 3

วิธีการ

GetConnectedWires

Instances

ส่งคืนคอลเลกชันของ Wires ปักหมุดAudioPlayer ปักหมุด"เอาต์พุต" หนึ่งตัว

พารามิเตอร์

pin: string
ค่าเริ่มต้น: ""

ส่งค่ากลับ

Instances

GetInputPins


ส่งค่ากลับ

GetOutputPins


ส่งค่ากลับ

Play

()

เล่น AudioPlayer จากทุกที่ที่เป็น TimePosition ของมัน สําเนาจากเซิร์ฟเวอร์ไปยังไคลเอนต์


ส่งค่ากลับ

()

Stop

()

หยุด AudioPlayer ทุกที่ที่ TimePosition ของมันอยู่ สําเนาจากเซิร์ฟเวอร์ไปยังไคลเอนต์


ส่งค่ากลับ

()

GetWaveformAsync

ผลตอบแทน

พารามิเตอร์

timeRange: NumberRange
ค่าเริ่มต้น: ""
samples: number
ค่าเริ่มต้น: ""

ส่งค่ากลับ

อีเวนต์

Ended

ไฟไหม้หลังจากที่ AudioPlayer เสร็จสิ้นการเล่นและหยุดโปรดทราบว่าอีเวนต์นี้จะ ไม่ ยิงสําหรับเสียงด้วย Looped ตั้งค่าเป็น true เนื่องจากยังคงเล่นต่อไปเมื่อถึงจุดสิ้นสุดอีเวนต์นี้จะไม่ ไม่ได้ ปิด; สำหรับสิ่งนี้ให้ใช้ AudioPlayer:GetPropertyChangedSignal() ในคุณสมบัติ IsPlaying

อีเวนต์นี้มักใช้เพื่อทําลาย AudioPlayer เมื่อเสร็จสิ้นการเล่น


Looped

อีเวนต์ที่จะยิงหลังจากลูป AudioPlayer รอบสิ่งนี้เกิดขึ้นเมื่อเสียงถึงจุดสิ้นสุดของเนื้อหา (หรือจุดสิ้นสุดของ LoopRegion ถ้ามันใช้งานอยู่) และ Looping เป็น true

อีเวนต์นี้ไม่ได้ ไม่ ยิงหากเสียงถูกเล่นซ้ำโดยการเปลี่ยน TimePosition ของมัน


WiringChanged

อีเวนต์ที่จะยิงหลังจากที่ Wire เชื่อมต่อหรือถูกตัดการเชื่อมต่อและ Wire ตอนนี้หรือเคยเชื่อมต่อกับพินบน AudioPlayer อินสแตนซ์

พารามิเตอร์

connected: boolean

ว่าตัวอย่างได้เชื่อมต่อหรือถูกตัดการเชื่อมต่อ

pin: string

เข็มบน AudioPlayer ที่เป้าหมาย Wire

wire: Wire

The Wire ระหว่าง AudioPlayer และตัวอย่างอื่น

instance: Instance

ตัวอย่างอื่นที่เชื่อมต่อผ่าน Wire หรือไม่