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 sumber daya audio. Ini menyediakan satu pin Output yang dapat dihubungkan 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 AssetId dimuat secara otomatis setelah diberikan.
Menunjukkan apakah AudioPlayer saat ini bermain.
Menentukan apakah AudioPlayer ini dimuat, disimpan, dan siap untuk dimainkan.
Sebuah range, dalam detik, menunjukkan awal dan akhir dari siklus di dalam PlaybackRegion dari AudioPlayer ini.
Mengontrol apakah siklus ini AudioPlayer atau tidak.
Jangkauan dalam detik menunjukkan waktu mulai yang diinginkan (minimum) dan waktu berhenti (maksimum) dalam TimeLength .
Mengontrol seberapa cepat aset akan dimainkan, yang mengontrol pitchnya.
Menunjukkan panjang aset yang dimuat.
Melacak posisi playhead saat ini dalam aset.
Mengontrol seberapa keras aset akan dimainkan.
Metode
Mengembalikan Wires yang terhubung ke mengepinyang ditentukan.
Memutar AudioPlayer dari mana pun di mana TimePosition nya.
Menghentikan AudioPlayer di mana pun TimePosition nya.
Acara
Dibakar saat AudioPlayer telah menyelesaikan pemutar dan berhenti.
Dibakar saat AudioPlayer loop.
Properti
AssetId
Aset untuk di-load ke dalam AudioPlayer . Jika AutoLoad benar, maka aset di-load segera setelah property ini di-assign. Saat pemuatan selesai, IsReady menjadi benar.
AutoLoad
Mengontrol apakah AssetId dimuat secara otomatis setelah diberikan. Jika benar, aset akan dimuat saat pertama usaha untuk bermain.
IsPlaying
Menunjukkan apakah AudioPlayer saat ini bermain. Prop ini hanya baca, tetapi bereplikasi. Untuk memainkan dan menghentikan AudioPlayer saat dijalankan, gunakan metode Play() dan 1> Class.AudioPlayer:Stop()|Stop()1>.
IsReady
Menunjukkan apakah AudioPlayer dimuat, diperbarui, dan siap untuk dimainkan. Meskipun tidak umum, AudioPlayers mungkin memiliki aset mereka tidak dimuat saat ekstrem tekanan memori, di mana kasus IsReady akan menjadi false.
LoopRegion
Sebuah range, dalam detik, menunjukkan awal dan akhir dari siklus di dalam PlaybackRegion dari AudioPlayer ini.
Jika LoopRegion minimum adalah lebih besar dari minimum PlaybackRegion, maka loop dimulai dari minimum 1> Class.AudioPlayer.LoopRegion|LoopRegion1> .
Jika LoopRegion minimum adalah kurang dari minimum PlaybackRegion, maka loop dimulai dari minimum 1> Class.AudioPlayer.PlaybackRegion|PlaybackRegion1> .
Jika LoopRegion maksimum adalah lebih besar dari maksimum PlaybackRegion, maka loop berakhir di 1> Class.AudioPlayer.PlaybackRegion|PlaybackRegion1> maksimum.
Jika LoopRegion maksimum adalah kurang dari maksimum PlaybackRegion, maka loop berakhir di persis 1> Class.AudioPlayer.LoopRegion|LoopRegion1> maksimum.
Jika LoopRegion minimum sama dengan LoopRegion maksimum, 1> Class.AudioPlayer1> menggunakan property 4> Class.AudioPlayer.PlaybackRegion|PlaybackRegion4> sebagai gantinya.
Looping
Mengontrol apakah siklus ini AudioPlayer ketika melebihi akhir dari TimeLength , LoopRegion , atau 1> Class.AudioPlayer.PlaybackRegion|PlaybackRegion1> .
PlaybackRegion
Jangkauan dalam detik menunjukkan waktu mulai yang diinginkan (minimum) dan waktu berhenti (maksimum) dalam TimeLength .
Jika PlaybackRegion minimum adalah lebih besar dari 0, suara dimulai bermain dari waktu minimum PlaybackRegion.
Jika PlaybackRegion minimum adalah kurang dari 0, suara dimulai bermain dari 0.
Jika PlaybackRegion maksimum adalah lebih besar dari TimeLength, suara berhenti di 1> Class.AudioPlayer.TimeLength|TimeLength1> .
Jika PlaybackRegion maksimum adalah kurang dari TimeLength, suara berhenti persis pada 1> Class.AudioPlayer.PlaybackRegion|PlaybackRegion1> maksimum.
Jika PlaybackRegion minimum Equals the PlaybackRegion maximum, sound bermain seluruh.
PlaybackSpeed
Pengganda mengontrol seberapa cepat aset akan dimainkan, secara langsung mengontrol pitch yang diterima. Berjalan dari 0 ke 20.
Volume
Volume level yang dikalikan ke audio stream keluar, mengontrol seberapa keras aset akan dimainkan. Berbagai dari 0 hingga 3.
Metode
GetConnectedWires
Mengembalikan matriks Class.Wire|Wires yang terhubung ke mengepinyang ditentukan. AudioPlayer memiliki satu mengepin"Output".
Parameter
Memberikan nilai
Play
Memutar AudioPlayer dari mana pun di mana TimePosition nya. Replikasi dari server ke klien.
Memberikan nilai
Stop
Menghentikan AudioPlayer di mana pun TimePosition nya. Replikasi dari server ke klien.
Memberikan nilai
Acara
Ended
Mengakhiri setel ulang setel ulang setel ulang setel ulang setel ulang setel ulang setel ulang setel ulang setel ulang setel ulang setel ulang setel ulang setel ulang setel ulang setel u
Acara ini sering digunakan untuk menghancurkan AudioPlayer ketika telah menyelesaikan pemutarannya.
Looped
Acara yang menyala setelah AudioPlayer loop. Ini terjadi ketika audio mencapai akhir konten (atau akhir LoopRegion jika aktif) dan Looping adalah 1> true1> .
Acara ini tidak menghasilkan tidak jika audio di-loop secara manual dengan mengubah TimePosition .