AudioCompressor
*Dieser Inhalt wurde mit KI (Beta) übersetzt und kann Fehler enthalten. Um diese Seite auf Englisch zu sehen, klicke hier.
AudioCompressor passt die dynamische Reichweite von Audio-Streams an. Alle vorübergehenden Ausbrüche von Lautstärke werden gemäß den Eigenschaften des Kompressors eingedämmt.
AudioCompressor bietet Eingabe und Seitenkette Pins, die von Wire.TargetName anvisiert werden können, und eine Ausgabe Pin, die von Wire.SourceName verwendet werden kann.
Code-Beispiele
By using Sidechain compression, the background ambience can be ducked around an explosion
local deviceOutput: AudioDeviceOutput = Instance.new("AudioDeviceOutput")
deviceOutput.Parent = workspace
local explosionPlayer: AudioPlayer = Instance.new("AudioPlayer")
explosionPlayer.Parent = workspace
explosionPlayer.AssetId = "rbxassetid://1835333184"
local ambiencePlayer = Instance.new("AudioPlayer")
ambiencePlayer.AssetId = "rbxassetid://9112854440"
local compressor = Instance.new("AudioCompressor")
local wireToCompressor = Instance.new("Wire")
local wireToSidechain = Instance.new("Wire")
local wireToOutput = Instance.new("Wire")
ambiencePlayer.Parent = workspace
compressor.Parent = workspace
wireToCompressor.Parent = workspace
wireToSidechain.Parent = workspace
wireToOutput.Parent = workspace
wireToCompressor.SourceInstance = ambiencePlayer
wireToCompressor.TargetInstance = compressor
wireToSidechain.SourceInstance = explosionPlayer
wireToSidechain.TargetInstance = compressor
wireToSidechain.TargetName = "Sidechain"
wireToOutput.SourceInstance = compressor
wireToOutput.TargetInstance = deviceOutput
ambiencePlayer:Play()Zusammenfassung
Eigenschaften
Steuert, wie schnell der Kompressor die Lautstärke reduziert, nachdem er Threshold überschritten hat.
Ob Audio-Streams unberührt bleiben, wenn dieser Effekt durchläuft.
Ein Gewinnwert, der nach der Komprimierung angewendet wird.
Verhältnis von Eingangsvolumen zu Ausgabevolumen, das anzuwenden ist, wenn Threshold überschritten wird.
Steuert, wie schnell der Kompressor nachlässt, nachdem der Stream-Volumen unter Threshold zurückgefallen ist.
Erhalte einen Wert, bei dem der Kompressor beginnt, den Streamzu modifizieren.
Methoden
Gibt eine Reihe von Wires, die mit dem angegebenen anheftenverbunden sind, zurück.
Ereignisse
Feuert, wenn eine andere Instanz über einen AudioCompressor mit der Wire verbunden oder getrennt wird.
Eigenschaften
Attack
Zeit, in Sekunden, die angibt, wie schnell der Kompressor die Lautstärke verringert, nachdem er Threshold überschritten hat. Reichweite von 0.001 bis 0.5.
Bypass
Wenn true , werden Audiodateien unberührt durchlaufen, von diesem Effekt nicht betroffen.
Editor
MakeupGain
Erhalte einen Wert, der nach der Komprimierung angewendet wird, in Dekibel.Nach der Einschränkung der dynamischen Reichweite kann der daraus resultierende Stream sehr leise sein und diese Eigenschaft kann zum Ausgleich verwendet werden.Reicht von -30 bis 30.
Ratio
Verhältnis von Eingangsvolumen zu Ausgabevolumen, das anzuwenden ist, wenn Threshold überschritten wird.Zum Beispiel wird ein Wert von 2 die Menge, mit der der Eingangsstream die Schwelle um die Hälfte überschreitet, immer dann halbieren, wenn der Eingangsstream das tut.Reicht von 1 bis 50.
Release
Zeit, in Sekunden, die angibt, wie schnell der Kompressor nach dem Rückgang seiner Streamlautstärke auf unter Threshold zurückklemmt. Reichweite von 0.01 bis 0.5.
Threshold
Erhalte einen Wert, bei dem der Kompressor beginnt, den Streamin Dekibel zu modifizieren, mit einem Bereich von -60 bis 0.Wenn die Lautstärke des StreamThreshold überschreitet, dauert es Attack Sekunden, bis der Kompressor eintritt.Wenn die Lautstärke des Streamunter Threshold sinkt, dauert es Release Sekunden, bis der Kompressor aufhört zu agieren.
Wenn irgendeine Wires mit der Seitenkette des Kompressors verbunden ist, analysiert diese Schwelle diese Streams anstelle der Eingangsstreams ; dies kann verwendet werden, um die Lautstärke eines Streams in Reaktion auf einen anderen zu drosseln.
Methoden
GetConnectedWires
Gibt eine Reihe von Wires, die mit dem angegebenen anheftenverbunden sind. AudioCompressor hat eine "Eingabe"anheften, eine "Seitenkette"anheftenund eine "Ausgabe"anheften.
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 AudioCompressor und mit einigen anderen verwendbaren Instanzen verbunden war.
Parameter
Ob die Instanz verbunden oder getrennt wurde.
Die Pins auf der AudioCompressor, die die Wire Ziele sind.
Die Wire zwischen der AudioCompressor und der anderen Instanz.