AudioListener
*Dieser Inhalt wurde mit KI (Beta) übersetzt und kann Fehler enthalten. Um diese Seite auf Englisch zu sehen, klicke hier.
AudioListener Aufnahmen eine Audio-Strahl von seinem Umgebung Class.
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 = output
Zusammenfassung
Eigenschaften
Repräsentiert, wie sich die wahrgenommene Lautstärke des abgestrahlten Sounds ändert, basierend auf dem Winkel zwischen einem AudioEmitter und dem LookVector mit dem AudioListener .
Steuerelemente, die AudioEmitters sind audible zu diesem AudioListener .
Repräsentiert, wie die wahrgenommene Lautstärke der abgestrahlten Sounds ändert, wenn die Distanz zwischen AudioEmitters und dem AudioListener erhöht wird.
Methoden
Erhalte die Ecken-Schwellungskurve, die die AudioListener verwendet, oder eine leere Tabelle, wenn sie die Standard-Kurve verwendet.
Gibt eine Matrix von Wires zurück, die mit dem angegebenen anheftenverbunden ist.
Erhalte die Entfernungskorrektur Kurve, die die AudioListener verwendet, oder eine leere Tabelle, wenn sie die Standard Kurve verwendet.
Setzt die Winkelabschwächungskurve, die der AudioListener verwenden sollte, oder verwendet eine konstante Kurve von Lautstärke 1 wenn keine angegeben wird.
Setzt die Entfernung-Attenuierungs-Kurve, die der AudioListener verwenden sollte, oder verwendet eine umgekehrte Rolloff-Kurve, wenn keine angegeben wird.
Eigenschaften
AngleAttenuation
Repräsentiert eine Lichtkurve, die die Lautstärke eines AudioListener ändert, basierend auf dem Winkel zwischen ihnen und dem AudioEmitter , der mit dem LookVector verbunden ist.
Diese Eigenschaft ist intern und kann nicht von Skripten aufgerufen werden; sie existiert, um die Replikation zu unterstützen. Siehe SetAngleAttenuation() für Details zur Verwendung.
AudioInteractionGroup
Steuerelemente, die AudioEmitters sind für diesen AudioListener sichtbar. Emitter, die eine Interaktionsgruppe teilen, können von diesem Listener gehört werden.
DistanceAttenuation
Repräsentiert eine Lichtkurve, die die Lautstärke des AudioListener , basierend auf der Distanz zwischen ihnen, beeinflusst.
Diese Eigenschaft ist intern und kann nicht von Skripten aufgerufen werden; sie existiert, um die Replikation zu unterstützen. Siehe SetDistanceAttenuation() für Details zur Verwendung.
Methoden
GetAngleAttenuation
Gibt einen Tabelle-Mapping-Winkel auf die Lautstärke zurück. Schlüssel sind Zahlen zwischen 0 und 180 (einschließlich), während Werte Zahlen zwischen 0 und 1> 11> (einschließlich) beschreiben, wie die Lautstärke abhängig von der Richtung abmildert. Diese Methode gibt eine leere Tabelle
Rückgaben
Tabellemapping-Winkel zum Volumen, wie oben beschrieben.
GetConnectedWires
Gibt eine Matrix von Wires zurück, die mit dem angegebenen anheftenverbunden ist. AudioListener hat einen "Output"anheften.
Parameter
Rückgaben
GetDistanceAttenuation
Gibt eine Tabelle zurück, um die Skalierung der Größe zu Volumen. Schlüssel sind Zahlen größer als oder gleich mit 0, während Werte Zahlen zwischen 0 und 1 (einschließlich) beschreiben, wie die Skalierung der Größe über die Distanz verringert. Dieser Methoden gibt eine leere Tabelle zurück, wenn die Standard-Skalierungskurve verwendet wird.
Rückgaben
GetInteractingEmitters
Rückgaben
SetAngleAttenuation
Setzt eine Lautstärke über Angulo-Kurve, die beeinflusst, wie laut ein Class.AudioListener``Class.AudioEmitter , basierend auf dem Winkel zwischen ihnen und dem LookVector , der mit dem 1> Class.AudioListen1> verbunden ist.
Die Kurve wird durch einen Tabelle-Mapping-Winkel-Schlüssel zu Lautstärke-Werten dargestellt. Schlüssel sind als einzigartige Zahlen zwischen 0 und 180 (einschließlich), während Lautstärke-Werte als Zahlen zwischen 0 und 1> 11> (einschließlich) unterstützt werden. Tabellen mit bis
Die Lautstärke eines AudioEmitter von der Perspektive des AudioListener in einem Winkel a ist bestimmt, indem die Volumenlevel für die Punkte auf
Diese Lautstärke wird mit den Lautstärken von allen anderen Abmilderungskurven (einschließlich jener auf dem Senden AudioEmitter ) multipliziert, um die endgültige Hörbarkeit zu erhalten.
Wenn die Tabelle leer ist oder nil, verwendet der AudioEmitter Standardmäßig eine Winkelabschwächungskurve mit dem konstanten Lautstärke-Wert von 1.
Parameter
Rückgaben
SetDistanceAttenuation
Setzt eine Lautstärke über Entfernung, die die Lautstärke des AudioListener , basierend auf der Entfernung zwischen ihnen, beeinflusst, basierend auf der Entfernung zwischen ihnen.
Die Kurve wird durch einen Tabelle-Map-Distance-Schlüssel für Volumenwerte dargestellt. Schlüssel sind erwartet einzigartige Zahlen größer als oder gleich mit 0, während Werte erwartet sind Zahlen zwischen 0 und 1 (einschließlich). Tabellen mit bis zu 400 Schlüssel-Wert-Paaren werden unterstützt.
Die Lautstärke eines AudioEmitter von der Perspektive des AudioListener in einer Entfernung von d ist durch lineare Interpolation zwischen den Lautstärke
Diese Lautstärke wird mit den Lautstärken von allen anderen Abmilderungskurven (einschließlich jener auf dem Senden AudioEmitter ) multipliziert, um die endgültige Hörbarkeit zu erhalten.
Wenn die Tabelle leer ist oder nil, wird die AudioListener Standard verwendet, um eine konstante Lautstärke überall zu verwenden.