AudioEqualizer

显示已弃用

*此内容使用人工智能（Beta）翻译，可能包含错误。若要查看英文页面，请点按此处。

AudioEqualizer 调整音频流的频率内容。它提供一个输入接口和一个输出接口，可以通过 Wires 连接到/从。AudioEqualizer 有 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