AudioCompressor
*Ce contenu est traduit en utilisant l'IA (Beta) et peut contenir des erreurs. Pour consulter cette page en anglais, clique ici.
AudioCompressor ajuste la plage dynamique des flux audio. Toute poussée momentanée de volume sera comprise selon les propriétés du compresseur.
AudioCompressor fournit entrée et pins de chaîne latérale qui peuvent être ciblés par Wire.TargetName , et un sortie pin qui peut être utilisé par Wire.SourceName .
Échantillons de code
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()Résumé
Propriétés
Contrôle la vitesse à laquelle le compresseur s'accrochera au volume après avoir dépassé Threshold.
Si les flux audio sont transmis sans être affectés par cet effet.
Une valeur de gain à appliquer après la compression.
Ratio du volume d'entrée au volume de sortie, à appliquer lors du dépassement de Threshold .
Contrôle la vitesse à laquelle le compresseur se détache rapidement après que la quantité de trafic ait baissé en dessous de Threshold.
Gain de valeur auquel le compresseur commencera à modifier le flux d'entrée.
Méthodes
Renvoie un tableau de Wires qui sont connectés au épinglerspécifié.
Évènements
Se déclenche lorsqu'une autre instance est connectée ou déconnectée du AudioCompressor via un Wire .
Propriétés
Attack
Temps, en secondes, indiquant à quelle vitesse le compresseur s'accrochera au volume après avoir dépassé Threshold. S'étend de 0.001 à 0.5.
Editor
MakeupGain
Gain de valeur à appliquer après la compression, en décibels.Après avoir limité la portée dynamique, le flux résultant peut être très silencieux et cette propriété peut être utilisée pour compenser.Va de -30 à 30.
Ratio
Ratio du volume d'entrée au volume de sortie, à appliquer lors du dépassement de Threshold .Par exemple, une valeur de 2 coupera le montant par lequel le flux d'entrée dépasse le seuil en moitié chaque fois que le flux d'entrée le fait.Va de 1 à 50.
Release
Temps, en secondes, indiquant à quelle vitesse le compresseur se détachera après que son volume de flux redescende en dessous de Threshold. S'étend de 0.01 à 0.5.
Threshold
Gain de valeur auquel le compresseur commencera à modifier le flux d'entrée, en décibels, avec une plage de -60 à 0.Lorsque le volume du flux d'entrée dépasse Threshold, le compresseur prendra Attack secondes pour intervenir.Lorsque le volume du flux d'entrée recule en dessous de Threshold, le compresseur prendra Release secondes pour cesser d'agir.
Si un Wires est connecté à l'épingle Sidechain du compresseur, ce seuil analyse ces flux au lieu des flux entrée ; cela peut être utilisé pour faire baisser le volume d'un flux en réponse à un autre.
Méthodes
GetConnectedWires
Retourne un tableau de Wires qui sont connectés au épinglerspécifié. AudioCompressor a un épingler« entrée », un épingler« chaîne latérale » et un épingler« sortie ».
Paramètres
Retours
Évènements
WiringChanged
Événement qui se déclenche après qu'un Wire devienne connecté ou déconnecté, et que Wire soit maintenant ou ait été précédemment connecté à un bouton sur le AudioCompressor et à une autre instance wirable.
Paramètres
Si l'instance s'est connectée ou déconnectée.
L'épingle sur le AudioCompressor que les cibles Wire .
Le Wire entre la AudioCompressor et l'autre instance.