AudioCompressor

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.

AudioCompressor dostosowuje dynamiczny zakres strumieni audio. Wszelkie chwilowe wzrosty głośności zostaną ograniczone zgodnie z właściwościami kompresora.

AudioCompressor dostarcza Wejście i szpilki łańcucha bocznego , które mogą być ukierunkowane przez Wire.TargetName , oraz szpilkę wyjścia , którą można używać przez Wire.SourceName .

Przykłady kodu

By using Sidechain compression, the background ambience can be ducked around an explosion

Sidechain Compression

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()

Podsumowanie

Właściwości

  • Odczyt równoległy

    Kontroluje, jak szybko kompresor będzie przytrzymywał głośność po przekroczeniu Threshold.

  • Odczyt równoległy

    Czy strumienie audio są przekazywane bez wpływu na ten efekt.

  • Bez replikacji
    Zabezpieczenia skryptów Roblox
    Odczyt równoległy
  • Odczyt równoległy

    Wartość zysku, która ma być zastosowana po skompresowaniu.

  • Odczyt równoległy

    Stosunek objętości wejściowej do objętości wyjściowej, który należy zastosować przy przekraczaniu Threshold .

  • Odczyt równoległy

    Kontroluje, jak szybko kompresor odpręża się po tym, jak objętość strumienia spadnie poniżej Threshold.

  • Odczyt równoległy

    Zdobądź wartość, przy której kompresor zacznie modyfikować strumień wejściowy.

Zdarzenia

Właściwości

Attack

Odczyt równoległy

Czas, w sekundach, określający, jak szybko kompresor zacisną się na objętości po przekroczeniu Threshold. Zakres od 0.001 do 0.5.

Bypass

Odczyt równoległy

Jeśli true, strumienie audio są przekazywane bez wpływu na ten efekt.

Editor

Bez replikacji
Zabezpieczenia skryptów Roblox
Odczyt równoległy

MakeupGain

Odczyt równoległy

Zdobądź wartość, która ma zostać zastosowana po kompresji, w decybelach.Po ograniczeniu dynamicznego zakresu wynikowy strumień może być bardzo cichy, a ta właściwość może być wykorzystana do kompensacji.Zakres od -30 do 30.

Ratio

Odczyt równoległy

Stosunek objętości wejściowej do objętości wyjściowej, który należy zastosować przy przekraczaniu Threshold .Na przykład wartość 2 zmniejszy ilość, w której strumień wejściowy przekracza próg w połowie za każdym razem, gdy tak się stanie.Zakres od 1 do 50.

Release

Odczyt równoległy

Czas, w sekundach, określający, jak szybko kompresor odpręża się po tym, jak jego objętość przepływu spadnie poniżej Threshold. Zakres od 0.01 do 0.5.

Threshold

Odczyt równoległy

Zdobądź wartość, przy której kompresor zacznie modyfikować streamowaćwejściowy, w decybelach, z zakresem od -60 do 0.Gdy głośność streamowaćwejściowego przekroczy Threshold, kompresor zajmie Attack sekund, aby wkroczyć.Gdy głośność streamowaćwejściowego spadnie poniżej Threshold, kompresor zajmie Release sekund, aby przestać działać.

Jeśli którykolwiek Wires jest podłączony do szpilki łańcucha bocznego kompresora, ten próg analizuje te strumienie zamiast strumieni wejściowych , można go użyć do zredukowania głośności jednego strumienia w odpowiedzi na inny.

Metody

GetConnectedWires

Instances

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

Parametry

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

Zwroty

Instances

GetInputPins


Zwroty

GetOutputPins


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 AudioCompressor i z niektórymi innymi dostępnymi instancjami.

Parametry

connected: boolean

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

pin: string

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

wire: Wire

The Wire pomiędzy AudioCompressor i inną instancja.

instance: Instance

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