AudioCompressor

非推奨を表示

*このコンテンツは、ベータ版のAI(人工知能)を使用して翻訳されており、エラーが含まれている可能性があります。このページを英語で表示するには、 こちら をクリックしてください。

AudioCompressor オーディオストリームの動的範囲を調整します。任意の音量の一時的なバーストは、コンプレッサーのプロパティに従って抑えられます。

AudioCompressor は、 入力 および サイドチェーン ピンを提供し、Wire.TargetName にターゲットにでき、 出力 ピンを Wire.SourceName に使用できます。

コードサンプル

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

概要

プロパティ

  • 並列読み取り

    コンプレッサーが Threshold を超えた後、どのくらい早く音量を抑えるかを制御します。

  • 並列読み取り

    オーディオストリームがこの効果に影響を受けずに通過するかどうか。

  • 複製されていません
    Robloxのスクリプトセキュリティ
    並列読み取り
  • 並列読み取り

    圧縮後に適用される獲得値。

  • 並列読み取り

    入力ボリューム対出力ボリュームの比率、Threshold を超えると適用されます。

  • 並列読み取り

    ストリームボリュームが Threshold 以下に減少した後、コンプレッサーがどれほど素早くクランプを解除するかを制御します。

  • 並列読み取り

    コンプレッサーが入力ストリームを変更開始する値を獲得します。

イベント

プロパティ

Attack

並列読み取り

時間、秒単位で、コンプレッサーが Threshold を超えた後、どれほど迅速にボリュームを抑えるかを示します。0.001から0.5までの範囲。

Bypass

並列読み取り

如果 true 、オーディオストリームはこの効果によって影響を受けずに通過します。

Editor

複製されていません
Robloxのスクリプトセキュリティ
並列読み取り

MakeupGain

並列読み取り

圧縮後に適用される値を、デシベルで獲得する。動的範囲を制限した後、結果のストリームは非常に静かになり、このプロパティを使用して補償できます。-30から30までの範囲。

Ratio

並列読み取り

入力ボリューム対出力ボリュームの比率、Threshold を超えると適用されます。たとえば、2 の値は、入力ストリームがそうするたびに、入力ストリームが境界を半分超える量を削減します。1から50までの範囲。

Release

並列読み取り

時間、秒単位で、コンプレッサーがストリームボリュームが Threshold 以下に減少した後、どれほど素早くクランプを解除するかを示します。0.01から0.5までの範囲。

Threshold

並列読み取り

コンプレッサーが入力ストリームを変更開始する値を、デシベルで、範囲 -60 から 0 まで獲得する入力ストリームのボリュームが Threshold を超えると、コンプレッサーが起動するまでに Attack 秒かかります。入力ストリームのボリュームが Threshold 以下に減少すると、コンプレッサーは動作を停止するまで Release 秒かかります。

任意の Wires がコンプレッサーの サイドチェーン ピンに接続されている場合、この境界値は、 入力 ストリームではなく、それらのストリームを分析します;これを使用すると、他のストリームに応答して1つのストリームのボリュームをダックできます。

方法

GetConnectedWires

Instances

指定されたピピン留めに接続された Wires のアレイを返します。AudioCompressor には「入力」ピピン留め、「サイドチェーン」ピピン留め、「出力」ピピン留めが 1つあります。

パラメータ

pin: string
既定値: ""

戻り値

Instances

GetInputPins


戻り値

GetOutputPins


戻り値

イベント

WiringChanged

Wire が接続または切断された後に発生するイベント、および Wire が現在または以前に AudioCompressor および他のワイヤー可能なインスタンスのピンに接続されているか、接続されていました。

パラメータ

connected: boolean

インスタンスが接続されたか、切断されたか。

pin: string

ターゲットの AudioCompressor にピンを打った Wire

wire: Wire

Wire と他のインスタンスの間の AudioCompressor

instance: Instance

Wire を介して接続された他のインスタンス。