AudioListener

Pokaż przestarzałe

*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

Camera Listener

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

Metody

Zdarzenia

Właściwości

AngleAttenuation

BinaryString
Zabezpieczenia na platformie Roblox
Odczyt równoległy

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

Odczyt równoległy

Sterowania, które AudioEmitters są słyszalne dla tego AudioListener . Nadawcy, którzy dzielą grupę interakcji, mogą być słyszani przez ten odbiorcę.

DistanceAttenuation

BinaryString
Zabezpieczenia na platformie Roblox
Odczyt równoległy

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.

Odczyt równoległy

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.

GetAudibilityFor

Parametry

emitter: AudioEmitter
Wartość domyślna: ""

Zwroty

GetConnectedWires

Instances

Zwraca tablicę Wires, która jest połączona z określonym przypinać. AudioListener ma jedną przypinać"Wyjście".

Parametry

pin: string
Wartość domyślna: ""

Zwroty

Instances

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

GetInputPins


Zwroty

GetInteractingEmitters

Instances

Zwroty

Instances

GetOutputPins


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

curve: Dictionary
Wartość domyślna: ""

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

curve: Dictionary
Wartość domyślna: ""

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

connected: boolean

Czy instancja została połączona czy odłączona.

pin: string

Przypinka na AudioListener , która jest przeznaczona dla celów Wire.

wire: Wire

The Wire pomiędzy AudioListener i inną instancja.

instance: Instance

Inna instancja, która jest lub była połączona za pośrednictwem Wire.