AudioListener
*Ta zawartość została przetłumaczona przy użyciu narzędzi AI (w wersji beta) i może zawierać błędy. Aby wyświetlić tę stronę w języku angielskim, kliknij tutaj.
AudioListener rejestruje strumień audio z otoczenia AudioEmitters w świecie 3D.Zapewnia pojedynczy Wyjście przypinek, który może być podłączony do innych przypinek za pomocą Wires .Jeśli rodzic jest , lub , świat rodzica zostanie wykorzystany do słuchania.Jeśli rodzic nie jest jedną z tych klas, AudioListener efektywnie nie słyszy nic.
Przykłady kodu
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
Podsumowanie
Właściwości
Reprezentuje, jak zmienia się postrzegany poziom dźwięku emitowanego w oparciu o kąt między AudioEmitter a LookVector związanym z AudioListener .
Sterowania, które AudioEmitters są słyszalne dla tego AudioListener .
Reprezentuje, jak zmienia się postrzegana objętość emitowanych dźwięków wraz z zwiększeniem odległości między AudioEmitters a AudioListener.
Metody
Zdobywa krzywą ograniczenia kąta, którą używa AudioListener, lub pustą tabelę, jeśli używa domyślnej krzywej.
Zwraca tablicę Wires, która jest połączona z określonym przypinać.
Zdobywa krzywą ograniczenia dystansu, którą używa AudioListener, lub pustą tabelę, jeśli używa domyślnej krzywej.
Ustawia krzywą zmniejszenia kąta, którą AudioListener powinien używać, lub używa stałą krzywą objętości 1, jeśli żadna nie jest dostarczana.
Ustawia krzywą wygaszania odległości, którą AudioListener powinien używać, lub używa odwrotnej krzywej wygaszania, jeśli żadna nie jest dostarczana.
Zdarzenia
Wystrzeliwuje, gdy inna instancja jest połączona z lub odłączona od AudioListener za pomocą Wire .
Właściwości
AngleAttenuation
Reprezentuje krzywą objętości-przez-kąt, która wpływa na to, jak głośno AudioListener usłyszy AudioEmitter , w oparciu o kąt między nimi i LookVector związany z AudioListener .
Właściwość ta jest wewnętrzna i nie może być dostępna dla skryptów; istnieje, aby wspierać replikację. Zobacz SetAngleAttenuation() dla szczegółów użytkowania.
AudioInteractionGroup
Sterowania, które AudioEmitters są słyszalne dla tego AudioListener . Nadawcy, którzy dzielą grupę interakcji, mogą być słyszani przez ten odbiorcę.
DistanceAttenuation
Reprezentuje krzywą objętości na odległość, która wpływa na to, jak głośno AudioListener słyszy każdy AudioEmitters, w oparciu o odległość między nimi.
Właściwość ta jest wewnętrzna i nie może być dostępna dla skryptów; istnieje, aby wspierać replikację. Zobacz SetDistanceAttenuation() dla szczegółów użytkowania.
SimulationFidelity
Metody
GetAngleAttenuation
Zwraca kąt mapowania tabeli do objętości.Klucze to liczby pomiędzy 0 a 180 (włącznie), podczas gdy wartości to liczby pomiędzy 0 a 1 (włącznie) opisujące, w jaki sposób zmniejsza się objętość w zależności od kierunku.Ta metoda zwraca pustą tabelę, jeśli używana jest domyślna krzywa zmniejszenia kąta.
Zwroty
Kąt mapowania tabeli do objętości, jak opisano powyżej.
GetConnectedWires
Zwraca tablicę Wires, która jest połączona z określonym przypinać. AudioListener ma jedną przypinać"Wyjście".
Parametry
Zwroty
GetDistanceAttenuation
Zwraca odległość mapowania tabeli do objętości.Klucze to liczby większe lub równe 0, podczas gdy wartości to liczby pomiędzy 0 a 1 (włącznie) opisujące, w jaki sposób zmniejsza się głośność na odległość.Ta metoda zwraca pusty stół, jeśli używana jest domyślna krzywa ograniczenia dystansu.
Zwroty
GetInteractingEmitters
Zwroty
SetAngleAttenuation
Ustawia krzywą głośności-na-kąt, która wpływa na to, jak głośno AudioListener usłyszy AudioEmitter , w oparciu o kąt między nimi i LookVector związany z AudioListener .
Krzywa jest reprezentowana przez klucze mapowania tablicy do wartości objętości.Oczekuje się, że klucze będą unikalnymi numerami pomiędzy 0 a 180 (włącznie), podczas gdy wartości będą numerami pomiędzy 0 a 1 (włącznie).Wspierane są tabele zawierające do 400 par kluczowych wartości.
Głosność AudioEmitter z perspektywy AudioListener w kącie a jest określana przez liniowe interpolowanie między poziomami objętości dla punktów na krzywej, których wartości kąta są bezpośrednio powyżej i poniżej a .Jeśli nie ma punktu poniżej a lub punktu powyżej a, wybierany jest poziom głośności innego punktu.Zasadniczo krzywa jest sekwencją punktów połączonych liniami proste, a poza jej lewym i prawym końcem krzywa rozciąga się na zewnątrz na ich odpowiednich poziomach głośności.
Ta objętość zostanie pomnożona przez objętości z wszystkich innych krzywych wygłuszania (w tym z tych na nadawaniu AudioEmitter ), aby uzyskać ostateczną słyszalność.
Jeśli tabela jest pusta lub nil , domyślnie używa się AudioEmitter kursu ograniczenia kąta z wartością stałej objętości 1 .
Parametry
Zwroty
SetDistanceAttenuation
Ustawia krzywą głośności na odległość, która wpływa na to, jak głośno AudioListener usłyszy każdy AudioEmitters, w oparciu o odległość między nimi.
Krzywa jest reprezentowana przez klucze mapowania tablicy do wartości objętości.Oczekuje się, że klucze będą unikalnymi numerami większymi niż lub równymi 0, podczas gdy wartości mają być liczbami pomiędzy 0 a 1 (włącznie).Wspierane są tabele zawierające do 400 par kluczowych wartości.
Głosność AudioEmitter z perspektywy AudioListener z odległością d jest określana przez liniową interpolację między poziomami głośności dla punktów na krzywej, których wartości odległości są bezpośrednio powyżej i poniżej d .Jeśli nie ma punktu poniżej d lub punktu powyżej d, wybierany jest poziom głośności innego punktu.Zasadniczo krzywa jest sekwencją punktów połączonych liniami proste, a poza jej lewym i prawym końcem krzywa rozciąga się w nieskończoność na ich odpowiednich poziomach głośności.
Ta objętość zostanie pomnożona przez objętości z wszystkich innych krzywych wygłuszania (w tym z tych na nadawaniu AudioEmitter ), aby uzyskać ostateczną słyszalność.
Jeśli tabela jest pusta lub nil , domyślnie AudioListener zostanie zastosowana stała objętość 1 wszędzie.
Parametry
Zwroty
Zdarzenia
WiringChanged
Wydarzenie, które wystrzeliwuje po tym, jak Wire łączy się lub odłącza się, a które Wire jest teraz połączone lub było wcześniej połączone z przypinką na AudioListener i z niektórymi innymi dostępnymi instancjami.
Parametry
Czy instancja została połączona czy odłączona.
Przypinka na AudioListener , która jest przeznaczona dla celów Wire.
The Wire pomiędzy AudioListener i inną instancja.