AudioListener
*Dieser Inhalt wurde mit KI (Beta) übersetzt und kann Fehler enthalten. Um diese Seite auf Englisch zu sehen, klicke hier.
AudioListener zeichnet einen Audiostream aus seiner Umgebung AudioEmitters in der 3D-Welt auf.Es bietet einen einzigen Ausgabe-Pin, der mit anderen Pins über verbunden werden kann.Wenn der Elternteil ein Attachment , Camera oder PVInstance ist, wird die Welt des übergeordnetes TeilCFrame zum Zuhören verwendet.Wenn der Eltern nicht eine dieser Klassen ist, hört der AudioListener effektiv nichts.
Code-Beispiele
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 = outputZusammenfassung
Eigenschaften
Repräsentiert, wie sich die wahrgenommene Lautstärke des abgestrahlten Sounds basierend auf dem Winkel zwischen einem AudioEmitter und dem LookVector , der mit dem AudioListener verbunden ist, ändert.
Steuerelemente, die für diesen AudioEmitters hörbar sind AudioListener.
Repräsentiert, wie sich die wahrgenommene Lautstärke der abgestrahlten Geräusche ändert, wenn die Entfernung zwischen AudioEmitters und AudioListener zunimmt.
Methoden
Holt sich die Angriffsverminderungskurve, die der AudioListener verwendet, oder eine leere Tabelle, wenn er die Standardkurve verwendet.
Gibt eine Reihe von Wires, die mit dem angegebenen anheftenverbunden sind, zurück.
Holt sich die Abstandsverminderungskurve, die der AudioListener verwendet, oder eine leere Tabelle, wenn er die Standardkurve verwendet.
Legt die Winkelabschwächungskurve fest, die die AudioListener verwenden sollte, oder verwendet eine konstante Kurve der Lautstärke 1, wenn keine bereitgestellt wird.
Legt die Abstandsverminderungskurve fest, die die AudioListener verwenden sollte, oder verwendet eine umgekehrte Rolloff-Kurve, wenn keine bereitgestellt wird.
Ereignisse
Feuert, wenn eine andere Instanz über einen AudioListener mit der Wire verbunden oder getrennt wird.
Eigenschaften
AngleAttenuation
Repräsentiert eine Lautstärke-über-Winkel-Kurve, die beeinflusst, wie laut ein AudioListener die AudioEmitter hört, basierend auf dem Winkel zwischen ihnen und dem LookVector , das mit dem AudioListener verbunden ist.
Diese Eigenschaft ist interne und kann nicht von Skripten aufgerufen werden; sie existiert, um die Replikation zu unterstützen. Siehe SetAngleAttenuation().
AudioInteractionGroup
Steuerelemente, die AudioEmitters hörbar sind für diese AudioListener. Emitter, die eine Interaktionsgruppe teilen, können von diesem Empfänger gehört werden.
DistanceAttenuation
Repräsentiert eine Lautstärke-über-Distanz-Kurve, die beeinflusst, wie laut der AudioListener jede AudioEmitters hört, basierend auf der Entfernung zwischen ihnen.
Diese Eigenschaft ist interne und kann nicht von Skripten aufgerufen werden; sie existiert, um die Replikation zu unterstützen. Siehe SetDistanceAttenuation().
SimulationFidelity
Methoden
GetAngleAttenuation
Gibt einen Tabelle-zu-Volumen-Angel zurück.Schlüssel sind Zahlen zwischen 0 und 180 (inklusive), während Werte Zahlen zwischen 0 und 1 sind (inklusive), die beschreiben, wie sich die Lautstärke abschwächt, abhängig von der Richtung.Diese Methode gibt eine leere Tabelle zurück, wenn die Standard-Angelreduktionskurve verwendet wird.
Rückgaben
Tabelle-zu-Volume-Angel wie oben beschrieben.
GetConnectedWires
Gibt eine Reihe von Wires, die mit dem angegebenen anheftenverbunden sind. AudioListener hat eine "Ausgabe"anheften.
Parameter
Rückgaben
GetDistanceAttenuation
Gibt eine Tabelle-zu-Volumen-Kartendistanz zurück.Schlüssel sind Zahlen größer als oder gleich 0, während Werte Zahlen zwischen 0 und 1 (einschließlich) sind, die beschreiben, wie sich Lautstärke über Entfernung verringert.Diese Methode gibt eine leere Tabelle zurück, wenn die Standardabstandsverminderungskurve verwendet wird.
Rückgaben
GetInteractingEmitters
Rückgaben
SetAngleAttenuation
Legt eine Lautstärke-über-Winkel-Kurve fest, die beeinflusst, wie laut ein AudioListener die AudioEmitter hört, basierend auf dem Winkel zwischen ihnen und dem LookVector , das mit dem AudioListener verbunden ist.
Die Kurve wird durch Tabellierungswinkel repräsentiert, die auf Lautstärkewerte zurückgreifen.Es wird erwartet, dass Schlüssel eindeutige Zahlen zwischen 0 und 180 (einschließlich) sind, während Werte Zahlen zwischen 0 und 1 (einschließlich) sein sollten.Tabellen mit bis zu 400 Schlüssel-Wert-Paaren werden unterstützt.
Die Lautstärke eines AudioEmitter von der Perspektive des AudioListener an einem Winkel a wird durch lineare Interpolation zwischen den Lautstärkeleveln für die Punkte auf der Kurve bestimmt, deren Winkelwerte direkt über und unter a liegen.Wenn es entweder keinen Punkt unter a oder keinen Punkt über a gibt, wird der Lautstärkepegel des anderen Punkts gewählt.Im Wesentlichen ist die Kurve eine Sequenz von Punkten, die durch gerade Linien verbunden sind, und jenseits ihrer linken und rechten Endpunkte erstreckt sich die Kurve nach außen auf ihre jeweiligen Lautstärkelevel.
Dieses Volumen wird mit den Volumen aller anderen Dämpfungskurven (einschließlich derjenigen auf der Übertragung AudioEmitter ) multipliziert, um die endgültige Hörbarkeit zu erhalten.
Wenn der Tisch leer oder nil ist, wird der AudioEmitter Standard verwendet, eine Winkelabschwächungskurve mit dem konstanten Lautstärkewert von 1 zu verwenden.
Parameter
Rückgaben
SetDistanceAttenuation
Legt eine Lautstärke-über-Distanz-Kurve fest, die beeinflusst, wie laut der AudioListener jede AudioEmitters hören wird, basierend auf der Entfernung zwischen ihnen.
Die Kurve wird durch Tabelle-Karten-Distanzschlüssel zu Lautstärke-Werten repräsentiert.Es wird erwartet, dass Schlüssel eindeutige Zahlen sind, die größer oder gleich 0 sind, während Werte Zahlen zwischen 0 und 1 (einschließlich) sein sollten.Tabellen mit bis zu 400 Schlüssel-Wert-Paaren werden unterstützt.
Die Lautstärke eines AudioEmitter von der Perspektive des AudioListener auf einer Entfernung von d wird durch lineare Interpolation zwischen den Lautstärkeleveln für die Punkte auf der Kurve bestimmt, deren Abstandswerte direkt über und unter d liegen.Wenn es entweder keinen Punkt unter d oder keinen Punkt über d gibt, wird der Lautstärkepegel des anderen Punkts gewählt.Im Wesentlichen ist die Kurve eine Sequenz von Punkten, die durch gerade Linien verbunden sind, und jenseits ihrer linken und rechten Endpunkte erstreckt sich die Kurve unendlich nach außen auf ihre jeweiligen Lautstärkelevel.
Dieses Volumen wird mit den Volumen aller anderen Dämpfungskurven (einschließlich derjenigen auf der Übertragung AudioEmitter ) multipliziert, um die endgültige Hörbarkeit zu erhalten.
Wenn der Tisch leer oder nil ist, wird die AudioListener Standardmäßig eine konstante Lautstärke von 1 überall angewendet.
Parameter
Rückgaben
Ereignisse
WiringChanged
Ereignis, das nachdem abgefeuert wird, nachdem ein Wire verbunden oder getrennt wurde, und das Wire jetzt oder zuvor mit einem Pin auf der AudioListener und mit einigen anderen verwendbaren Instanzen verbunden war.
Parameter
Ob die Instanz verbunden oder getrennt wurde.
Die Pins auf der AudioListener, die die Wire Ziele sind.
Die Wire zwischen der AudioListener und der anderen Instanz.