AudioListener
*Nội dung này được dịch bằng AI (Beta) và có thể có lỗi. Để xem trang này bằng tiếng Anh, hãy nhấp vào đây.
AudioListener ghi lại một luồng âm thanh từ môi trường xung quanh của nó AudioEmitters trong thế giới 3D.Nó cung cấp một đầu ra duy nhất có thể kết nối với các đầu nối khác thông qua Wires .Nếu cha là một , , hoặc , thế giới của cha sẽ được sử dụng để lắng nghe.Nếu cha không phải là một trong những lớp này, AudioListener hiệu quả không nghe thấy gì.
Mẫu mã
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 = outputTóm Tắt
Thuộc Tính
Biểu diễn cách âm lượng cảm nhận của âm thanh phát thay đổi dựa trên góc giữa một AudioEmitter và LookVector liên quan đến AudioListener .
Các điều khiển mà AudioEmitters có thể nghe được đối với AudioListener này.
Biểu diễn cách âm lượng phát ra thay đổi khi khoảng cách giữa AudioEmitters và AudioListener tăng lên.
Phương Pháp
Nhận được đường cong giảm góc mà AudioListener đang sử dụng, hoặc một bảng trống nếu nó sử dụng đường cong mặc định.
Trả về một array của Wires được kết nối với ghimđược chỉ định.
Nhận được đường cong giảm khoảng cách mà AudioListener đang sử dụng, hoặc một bảng trống nếu nó sử dụng đường cong mặc định.
Đặt đường cong giảm góc mà AudioListener nên sử dụng hoặc sử dụng một đường cong cố định về âm lượng 1 nếu không có gì được cung cấp.
Đặt đường cong suy giảm khoảng cách mà AudioListener nên sử dụng hoặc sử dụng đường cong suy giảm đảo ngược nếu không có gì được cung cấp.
Sự Kiện
Bắt lửa khi một instance khác được kết nối hoặc thoát kết nối với AudioListener qua một Wire .
Thuộc Tính
AngleAttenuation
Biểu diễn một đường cong âm lượng-theo-góc ảnh hưởng đến cách lớn tiếng một AudioListener sẽ nghe được AudioEmitter , dựa trên góc giữa chúng và LookVector liên quan đến AudioListener .
Thuộc tính này là nội bộ và không thể truy cập bởi các kịch bản; nó tồn tại để hỗ trợ sao chép. Xem SetAngleAttenuation() đối với chi tiết sử dụng.
AudioInteractionGroup
Các điều khiển mà AudioEmitters có thể nghe được đối với điều này AudioListener. Các phát sóng có chia sẻ nhóm tương tác có thể được nghe thấy bởi người lắng nghe này.
DistanceAttenuation
Biểu diễn một đường cong âm lượng qua khoảng cách ảnh hưởng đến cách mạnh mẽ mà AudioListener nghe bất kỳ AudioEmitters , dựa trên khoảng cách giữa chúng.
Thuộc tính này là nội bộ và không thể truy cập bởi các kịch bản; nó tồn tại để hỗ trợ sao chép. Xem SetDistanceAttenuation() đối với chi tiết sử dụng.
SimulationFidelity
Phương Pháp
GetAngleAttenuation
Trả về một góc độ bản đồ bảng lên khối lượng.Các chìa khóa là số từ 0 đến 180 (bao gồm), trong khi các giá trị là số từ 0 đến 1 (bao gồm) mô tả cách giảm âm lượng tùy thuộc vào hướng.Phương pháp này trả về một bảng trống nếu đường cong giảm thiểu góc mặc định đang được sử dụng.
Lợi Nhuận
Góc định vị bảng đến âm lượng, như đã mô tả ở trên.
GetConnectedWires
Trả về một array của Wires được kết nối với ghimđầu ra được chỉ định. AudioListener có một ghim"Output".
Tham Số
Lợi Nhuận
GetDistanceAttenuation
Trả về khoảng cách bản đồ bảng lên khối lượng.Chìa khóa là số lớn hơn hoặc bằng 0, trong khi giá trị là số nằm giữa 0 và 1 (bao gồm) mô tả cách giảm âm lượng theo khoảng cách.Phương pháp này trả về một bảng trống nếu đường cong giảm khoảng cách mặc định đang được sử dụng.
Lợi Nhuận
GetInteractingEmitters
Lợi Nhuận
SetAngleAttenuation
Đặt một đường cong âm lượng-theo-góc ảnh hưởng đến cách lớn tiếng một AudioListener sẽ nghe được AudioEmitter , dựa trên góc giữa chúng và LookVector liên quan đến AudioListener .
Đường cong được biểu diễn bằng các phím đại diện cho góc bản đồ bảng đến giá trị khối lượng.Các chìa khóa được mong đợi là các số duy nhất giữa 0 và 180 (bao gồm), trong khi các giá trị được mong đợi là các số giữa 0 và 1 (bao gồm).Các bảng chứa tối đa 400 cặp chìa khóa-giá trị được hỗ trợ.
Âm lượng của một AudioEmitter từ quan điểm của AudioListener ở một góc a được xác định bằng cách dịch chuyển song song giữa các cấp độ âm lượng cho các điểm trên đường cong mà các giá trị góc của chúng nằm trực tiếp trên và dưới a .Nếu không có điểm nào dưới a hoặc không có điểm nào trên a , cấp độ âm lượng của điểm khác được chọn.Về cơ bản, đường cong là một chuỗi các điểm được kết nối bởi các đường thẳng, và ngoài các điểm cuối cùng bên trái và bên phải, đường cong mở rộng ra ngoài tại các mức âm lượng tương ứng của chúng.
Khối lượng này sẽ được nhân với các khối lượng từ tất cả các đường cong giảm thanh khác (bao gồm cả những khối lượng trên đường truyền gửi AudioEmitter ) để có được độ nghe cuối cùng.
Nếu bảng trống hoặc nil , AudioEmitter mặc định sử dụng một đường cong giảm góc với giá trị tĩnh của volume là 1 .
Tham Số
Lợi Nhuận
SetDistanceAttenuation
Đặt một đường cong âm lượng qua khoảng cách ảnh hưởng đến cách to lớn mà AudioListener sẽ nghe bất kỳ AudioEmitters nào, dựa trên khoảng cách giữa chúng.
Đường cong được đại diện bởi các phím định vị khoảng cách bản đồ bảng đến giá trị khối lượng.Các chìa khóa được mong đợi là các số duy nhất lớn hơn hoặc bằng 0, trong khi các giá trị được mong đợi là các số từ 0 đến 1 (bao gồm cả).Các bảng chứa tối đa 400 cặp chìa khóa-giá trị được hỗ trợ.
Âm lượng của một AudioEmitter từ quan điểm của AudioListener ở một khoảng cách d được xác định bằng cách dịch chuyển song song giữa các mức âm lượng cho các điểm trên đường cong có giá trị khoảng cách trực tiếp trên và dưới d .Nếu không có điểm nào dưới d hoặc không có điểm nào trên d , cấp độ âm lượng của điểm khác được chọn.Về cơ bản, đường cong là một chuỗi các điểm được kết nối bởi các đường thẳng, và ngoài các điểm cuối cùng bên trái và bên phải, đường cong mở rộng vô cực tại các mức âm lượng tương ứng của chúng.
Khối lượng này sẽ được nhân với các khối lượng từ tất cả các đường cong giảm thanh khác (bao gồm cả những khối lượng trên đường truyền gửi AudioEmitter ) để có được độ nghe cuối cùng.
Nếu bảng trống hoặc nil , AudioListener mặc định áp dụng một lượng cố định của 1 ở mọi nơi.
Tham Số
Lợi Nhuận
Sự Kiện
WiringChanged
Sự kiện xảy ra sau khi một Wire được kết nối hoặc mất kết nối, và sự kiện Wire bây giờ hoặc đã từng kết nối với một chốt trên AudioListener và một số ví ví dụ / trường hợpkhác có thể kết nối được.
Tham Số
Whether ví dụ đã kết nối hay mất kết nối.
Chốt trên AudioListener mà mục tiêu Wire nhắm.
Các Wire giữa AudioListener và ví dụ / trường hợpkhác.