AudioPlayer
*Konten ini diterjemahkan menggunakan AI (Beta) dan mungkin mengandung kesalahan. Untuk melihat halaman ini dalam bahasa Inggris, klik di sini.
AudioPlayer digunakan untuk memutar aset audio. Ini menyediakan satu pin Output yang dapat terhubung ke pin lain melalui Wires .
Contoh Kode
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()Rangkuman
Properti
Aset yang akan dimuat ke dalam AudioPlayer .
Mengontrol apakah Asset memuat secara otomatis setelah ditugaskan.
Menunjukkan apakah ini AudioPlayer saat ini sedang dimainkan.
Menunjukkan apakah ini AudioPlayer dimuat, disimpan, dan siap untuk dimainkan.
Sebuah rentang, dalam beberapa detik, menunjukkan awal dan akhir loop yang diinginkan dalam PlaybackRegion dari ini AudioPlayer.
Mengontrol apakah loop ini AudioPlayer berulang.
Jangkauan dalam detik menunjukkan waktu awal yang diinginkan (minimal) dan waktu berhenti (maksimal) dalam TimeLength .
Mengontrol seberapa cepat aset akan diputar, yang mengontrol pitchnya.
Menunjukkan panjang aset yang dimuat.
Pelacakan posisi playhead saat ini di dalam aset.
Mengontrol seberapa keras aset akan diputar.
Metode
Kembalikan array dari Wires yang terhubung ke mengepinyang ditentukan.
Memainkan AudioPlayer dari mana pun lokasinya TimePosition .
Menghentikan AudioPlayer di mana pun lokasinya TimePosition .
Acara
Memicu ketika AudioPlayer telah menyelesaikan pemutaran dan berhenti.
Memicu ketika loop AudioPlayer terbakar.
Memicu ketika instansi lain terhubung ke atau terputus dari AudioPlayer melalui Wire .
Properti
Asset
Aset yang akan dimuat ke dalam AudioPlayer .Jika AutoLoad adalah true , aset dimuat segera setelah properti ini ditetapkan.Saat pemuatan selesai, IsReady menjadi true .
AutoLoad
Mengontrol apakah Asset memuat secara otomatis setelah ditugaskan. Jika false , aset akan dimuat pada upaya pertama untuk dimainkan.
IsPlaying
Menunjukkan apakah ini AudioPlayer saat ini sedang dimainkan.Properti ini hanya dibaca, tetapi menyalin.Untuk memainkan dan menghentikan AudioPlayer pada saat eksekusi, gunakan metode Play() dan Stop().
IsReady
Menunjukkan apakah ini AudioPlayer dimuat, disimpan, dan siap untuk dimainkan.Meskipun tidak biasa, AudioPlayers mungkin memiliki aset mereka tidak dimuat saat menjalankan jika ada tekanan memori ekstrim, di mana kemudian IsReady akan menjadi salah.
LoopRegion
Sebuah rentang, dalam beberapa detik, menunjukkan awal dan akhir loop yang diinginkan dalam PlaybackRegion dari ini AudioPlayer.
Jika minimum LoopRegion minimum adalah lebih besar dari minimum PlaybackRegion, loop dimulai dari minimum LoopRegion.
Jika minimum LoopRegion minimum adalah kurang dari minimum PlaybackRegion, loop dimulai dari minimum PlaybackRegion.
Jika batas maksimum LoopRegion adalah lebih besar dari batas maksimum PlaybackRegion, loop berakhir di batas maksimum PlaybackRegion.
Jika batas maksimum LoopRegion adalah kurang dari batas maksimum PlaybackRegion, loop berakhir tepat pada batas maksimum LoopRegion.
Jika minimum LoopRegion sama dengan LoopRegion maksimum, AudioPlayer menggunakan properti PlaybackRegion alih.
Looping
Mengontrol apakah loop ini AudioPlayer ketika melebihi akhir dari TimeLength , LoopRegion , atau PlaybackRegion .
PlaybackRegion
Jangkauan dalam detik menunjukkan waktu awal yang diinginkan (minimal) dan waktu berhenti (maksimal) dalam TimeLength .
Jika minimum PlaybackRegion minimum adalah lebih besar dari 0, suara mulai diputar dari waktu minimum PlaybackRegion.
Jika minimum PlaybackRegion minimum adalah kurang dari 0, suara mulai diputar dari 0.
Jika batas maksimum PlaybackRegion adalah lebih besar dari TimeLength, suara berhenti di TimeLength.
Jika batas maksimum PlaybackRegion adalah kurang dari TimeLength, suara berhenti tepat pada batas maksimum PlaybackRegion.
Jika minimum PlaybackRegion sama dengan PlaybackRegion maksimum, suara dimainkan secara keseluruhan.
PlaybackSpeed
Pengganda mengontrol seberapa cepat aset akan dimainkan, langsung mengontrol pitch yang terasa. Berkisar dari 0 hingga 20.
Volume
Tingkat volume yang dikalikan ke streamaudio output, mengontrol seberapa keras aset akan diputar. Berkisar dari 0 hingga 3.
Metode
GetConnectedWires
Kembalikan array dari Wires yang terhubung ke mengepinyang ditentukan. AudioPlayer memiliki satu mengepin"Output".
Parameter
Memberikan nilai
Play
Memainkan AudioPlayer dari mana pun lokasinya TimePosition. Replikasi dari server ke klien.
Memberikan nilai
Stop
Menghentikan AudioPlayer di mana pun lokasinya TimePosition . Replikasi dari server ke klien.
Memberikan nilai
GetWaveformAsync
Parameter
Memberikan nilai
Acara
Ended
Api setelah AudioPlayer selesai diputar dan berhenti.Perhatikan acara ini tidak akan tidak menembak untuk audio dengan Looped diatur ke true karena terus bermain saat mencapai akhiri.Acara ini juga tidak terbakar ketika audio dihentikan sebelum pemutaran selesai; untuk ini, gunakan AudioPlayer:GetPropertyChangedSignal() pada properti IsPlaying.
Acara ini sering digunakan untuk menghancurkan AudioPlayer ketika sudah menyelesaikan pemutaran.
Looped
Peristiwa yang menembak setelah loop AudioPlayer terakhir.Ini terjadi ketika audio mencapai akhir kontennya (atau akhir dari LoopRegion jika aktif) dan Looping adalah true .
Acara ini tidak tidak memicu api jika audio diputar secara manual dengan mengubah TimePosition nya.
WiringChanged
Peristiwa yang menembak setelah Wire terhubung atau terputus, dan bahwa Wire sekarang atau sebelumnya terhubung ke pin di AudioPlayer dan ke beberapa kejadianlain yang dapat ditransmisikan.
Parameter
Apakah instansi terhubung atau terputus.
Pin pada AudioPlayer yang menjadi target Wire .
The Wire antara AudioPlayer dan instansi lainnya.