AudioEqualizer

顯示已棄用項目

*此內容是使用 AI（Beta 測試版）翻譯，可能含有錯誤。若要以英文檢視此頁面，請按一下這裡。

Class.AudioEqualizer 調整音頻流的頻率內容。提供一個輸入輸入針和一個輸出輸出針，可以連接到/從 0> Class.Wire|Wires0> 。 AudioEqualizer3> 有 3 個�

範例程式碼

An AudioEqualizer can be used to change the frequency content of audio streams. This can be done before emission, or after listening, and can be used to implement your own, custom RollOff logic! In this example, we use an AudioEqualizer to make an AudioPlayer's high frequencies more muffled as the AudioListener looks away from the AudioEmitter. We also reduce both the low and high frequencies as the listener gets further away.

Listener Equalization

local function wireUp(source: Instance, target: Instance) : Wire
    local wire = Instance.new("Wire")
    wire.Parent = target
    wire.SourceInstance = source
    wire.TargetInstance = target
    return wire
end

local function getCFrameFrom(inst: Instance) : CFrame?
    local parent = inst.Parent
    if not parent then
        return nil
    elseif parent:IsA("Model") then
        return parent.WorldPivot
    elseif parent:IsA("BasePart") then
        return parent.CFrame
    elseif parent:IsA("Attachment") then
        return parent.WorldCFrame
    elseif parent:IsA("Camera") then
        return parent.CFrame
    else
        return nil
    end
end

local function rescale(value: number, oldRange: NumberRange, newRange: NumberRange) : number
    local clamped = math.clamp(value, oldRange.Min, oldRange.Max)
    local normalized = clamped - oldRange.Min / (oldRange.Max - oldRange.Min)
    return normalized * (newRange.Max - newRange.Min) + newRange.Min
end

local assetPlayer = Instance.new("AudioPlayer")
assetPlayer.AssetId = "rbxassetid://142376088"
assetPlayer.Parent = workspace

local equalizer = Instance.new("AudioEqualizer")
equalizer.MidRange = NumberRange.new(400, 3000)
equalizer.Parent = workspace

local emitterPart = Instance.new("Part")
emitterPart.Anchored = true
emitterPart.Position = Vector3.new(0, 5, 0)
emitterPart.Parent = workspace

local emitter = Instance.new("AudioEmitter")
emitter.Parent = emitterPart

local listener = Instance.new("AudioListener")
listener.Parent = workspace.CurrentCamera

local output = Instance.new("AudioDeviceOutput")
output.Parent = workspace

wireUp(assetPlayer, equalizer)
wireUp(equalizer, emitter)
wireUp(listener, output)

assetPlayer.Looping = true
assetPlayer:Play()

while true do
    local emitterFrame = getCFrameFrom(emitter)
    local listenerFrame = getCFrameFrom(listener)
    if emitterFrame and listenerFrame then
        local towardEmitter = emitterFrame.Position - listenerFrame.Position
        local look = towardEmitter.Unit:Dot(listenerFrame.LookVector) -- ranges from [-1, 1]
        look = rescale(look, NumberRange.new(-1, 1), NumberRange.new(-20, 0))

        local distance = math.max(towardEmitter.Magnitude, 1)
        local rolloff = 1 / distance -- ranges from [0, 1]
        rolloff = rescale(rolloff, NumberRange.new(0, 1), NumberRange.new(-10, 10))

        equalizer.HighGain = look + rolloff
        equalizer.LowGain = rolloff
    end
    task.wait()
end