AudioListener
*Konten ini diterjemahkan menggunakan AI (Beta) dan mungkin mengandung kesalahan. Untuk melihat halaman ini dalam bahasa Inggris, klik di sini.
AudioListener mencatat aliran audio dari lingkungannya AudioEmitters di dunia 3D.Ini menyediakan satu Output pin yang dapat terhubung ke pin lain melalui Wires .Jika orangtua adalah , , atau , dunia orangtua akan digunakan untuk mendengarkan.Jika orangtua bukan salah satu Kelasini, AudioListener efektif tidak mendengar apa pun.
Contoh Kode
local listener = Instance.new("AudioListener")
local output = Instance.new("AudioDeviceOutput")
local wire = Instance.new("Wire")
listener.Parent = workspace.Camera
wire.Parent = listener
output.Parent = wire
wire.SourceInstance = listener
wire.TargetInstance = output
Rangkuman
Properti
Mewakili bagaimana volume yang dirasakan dari suara yang dipancarkan berubah berdasarkan sudut antara AudioEmitter dan LookVector yang terkait dengan AudioListener.
Kontrol yang AudioEmitters dapat didengar oleh ini AudioListener .
Mewakili bagaimana volume persepsi suara yang dipancarkan berubah saat jarak antara AudioEmitters dan AudioListener meningkat.
Metode
Mendapatkan kurva penurunan sudut yang digunakan oleh AudioListener, atau tabel kosong jika menggunakan kurva default.
Kembalikan array dari Wires yang terhubung ke mengepinyang ditentukan.
Mendapatkan kurva penurunan jarak yang digunakan oleh AudioListener, atau tabel kosong jika menggunakan kurva default.
Mengatur kurva penurunan sudut yang harus digunakan oleh AudioListener , atau menggunakan kurva konstan volume 1 jika tidak ada yang disediakan.
Tetapkan kurva penurunan jarak yang harus digunakan oleh AudioListener, atau gunakan kurva rolloff terbalik jika tidak ada yang disediakan.
Acara
Memicu ketika instansi lain terhubung ke atau terputus dari AudioListener melalui Wire .
Properti
AngleAttenuation
Mewakili kurva volume-over-angle yang mempengaruhi seberapa keras AudioListener akan mendengar AudioEmitter , berdasarkan sudut di antara mereka dan LookVector yang terkait dengan AudioListener .
Properti ini internal dan tidak dapat diakses oleh skrip; ada untuk mendukung replikasi. Lihat SetAngleAttenuation() untuk rincian penggunaan.
AudioInteractionGroup
Kontrol yang AudioEmitters dapat didengar oleh ini AudioListener . Pemancar yang berbagi kelompok interaksi dapat didengar oleh Pendengar ini.
DistanceAttenuation
Mewakili kurva volume-over- jarak yang mempengaruhi seberapa keras AudioListener mendengar apa pun AudioEmitters , berdasarkan jarak di antara mereka.
Properti ini internal dan tidak dapat diakses oleh skrip; ada untuk mendukung replikasi. Lihat SetDistanceAttenuation() untuk rincian penggunaan.
SimulationFidelity
Metode
GetAngleAttenuation
Kembalikan sudut pemetaan tabel ke volume.Kunci adalah angka di antara 0 dan 180 (termasuk), sementara nilai adalah angka di antara 0 dan 1 (termasuk) yang menggambarkan bagaimana volume berkurang tergantung pada arah.Metode ini menghasilkan tabel kosong jika kurva penurunan sudut default digunakan.
Memberikan nilai
Sudut peta tabel ke volume, seperti yang dijelaskan di atas.
GetConnectedWires
Kembalikan array dari Wires yang terhubung ke mengepinyang ditentukan. AudioListener memiliki satu mengepin"Output".
Parameter
Memberikan nilai
GetDistanceAttenuation
Kembalikan jarak pemetaan tabel ke volume.Kunci adalah angka lebih besar atau sama dengan 0, sementara nilai adalah angka antara 0 dan 1 (termasuk) yang menggambarkan bagaimana volume menurun dari jarak.Metode ini men返回 kosong meja jika kurva penyusutan jarak default digunakan.
Memberikan nilai
GetInteractingEmitters
Memberikan nilai
SetAngleAttenuation
Mengatur kurva volume-over-angle yang mempengaruhi seberapa keras AudioListener akan mendengar AudioEmitter , berdasarkan sudut di antara mereka dan LookVector yang terkait dengan AudioListener .
Lengkungan diwakili oleh kunci peta tabel ke nilai volume.Diharapkan kunci menjadi angka unik di antara 0 dan 180 (termasuk), sementara nilai diharapkan menjadi angka di antara 0 dan 1 (termasuk).Tabel yang berisi hingga 400 pasangan kunci-nilai dapat didukung.
Volume dari AudioEmitter dari perspektif AudioListener pada sudut a ditentukan dengan interpolasi linier antara tingkat volume untuk titik-titik pada kurva yang nilai sudutnya berada langsung di atas dan di bawah a .Jika tidak ada poin di bawah a atau tidak ada poin di atas a , tingkat volume dari titik lain dipilih.Pada dasarnya, kurva adalah serangkaian titik yang terhubung oleh garis lurus, dan di luar titik akhir kiri dan kanannya, kurva memanjang ke luar pada tingkat volume masing-masing.
Volume ini akan dikalikan dengan volume dari semua kurva penyempurnaan lainnya (termasuk yang di pengiriman AudioEmitter ) untuk mendapatkan audibilitas akhir.
Jika tabel kosong atau nil , AudioEmitter default menggunakan kurva penurunan sudut dengan nilai konstan volume 1 .
Parameter
Memberikan nilai
SetDistanceAttenuation
Mengatur kurva volume-over- jarak yang mempengaruhi seberapa keras AudioListener akan mendengar setiap AudioEmitters, berdasarkan jarak di antara mereka.
Lengkungan diwakili oleh kunci peta tabel ke jarak volume.Diharapkan kunci adalah angka unik lebih besar dari atau sama dengan 0, sementara nilai diharapkan menjadi angka antara 0 dan 1 (termasuk).Tabel yang berisi hingga 400 pasangan kunci-nilai dapat didukung.
Volume dari AudioEmitter dari perspektif AudioListener pada jarak d ditentukan dengan interpolasi linier antara tingkat volume untuk titik pada kurva yang jaraknya langsung di atas dan di bawah d .Jika tidak ada poin di bawah d atau tidak ada poin di atas d , tingkat volume dari titik lain dipilih.Pada dasarnya, kurva adalah serangkaian titik yang terhubung oleh garis lurus, dan di luar titik akhir kiri dan kanannya, kurva memanjang tanpa batas di tingkat volume masing-masing.
Volume ini akan dikalikan dengan volume dari semua kurva penyempurnaan lainnya (termasuk yang di pengiriman AudioEmitter ) untuk mendapatkan audibilitas akhir.
Jika tabel kosong atau nil , AudioListener default menerapkan volume konstan 1 di mana-mana.
Parameter
Memberikan nilai
Acara
WiringChanged
Peristiwa yang menembak setelah Wire terhubung atau terputus, dan bahwa Wire sekarang atau sebelumnya terhubung ke pin di AudioListener dan ke beberapa kejadianlain yang dapat ditransmisikan.
Parameter
Apakah instansi terhubung atau terputus.
Pin pada AudioListener yang menjadi target Wire .
The Wire antara AudioListener dan instansi lainnya.