學習
引擎類別
AudioFilter

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


概要
活動
WiringChanged(connected: boolean,pin: string,wire: Wire,instance: Instance):RBXScriptSignal
繼承成員
範例程式碼
發射器過濾
-- 這假設工作區包含一個帶有 AudioEmitter 和 AudioPlayer 的 Part,以及相機有一個 AudioListener
local RunService = game:GetService("RunService")
local part: BasePart = workspace.Part
local camera: Camera = workspace.CurrentCamera
local audioPlayer: AudioPlayer = part.AudioPlayer
local audioEmitter: AudioEmitter = part.AudioEmitter
local audioListener: AudioListener = camera.AudioListener
local raycastParams = RaycastParams.new()
raycastParams.FilterDescendantsInstances = { audioEmitter.Parent }
raycastParams.FilterType = Enum.RaycastFilterType.Exclude
-- 創建一個新的 AudioFilter
local filter: AudioFilter = Instance.new("AudioFilter")
filter.FilterType = Enum.AudioFilterType.Lowpass12dB
filter.Frequency = 22000
filter.Q = math.sqrt(2) / 2 -- 此 Q 值產生針對 12dB 斜率類型的平坦低通
filter.Parent = part
-- 將 AudioFilter 放在播放器和發射器之間
local function wireTo(source: Instance, target: Instance): Wire
local wire = Instance.new("Wire")
wire.SourceInstance = source
wire.TargetInstance = target
wire.Parent = target
end
wireTo(audioPlayer, filter)
wireTo(filter, audioEmitter)
-- 根據發射器和聽者的位置更新過濾器
RunService.Heartbeat:Connect(function()
local emitterPos: Vector3 = part.Position
local listenerPos: Vector3 = camera.CFrame.Position
local raycastResult = workspace:Raycast(emitterPos, (listenerPos - emitterPos), raycastParams)
filter.Frequency = if raycastResult then 500 else 22000
end)

API 參考
屬性
Bypass
平行讀取
功能: Audio
AudioFilter.Bypass:boolean

FilterType
平行讀取
功能: Audio
AudioFilter.FilterType:Enum.AudioFilterType

Frequency
平行讀取
功能: Audio
AudioFilter.Frequency:number

Gain
平行讀取
功能: Audio
AudioFilter.Gain:number

Q
平行讀取
功能: Audio
AudioFilter.Q:number

方法
GetConnectedWires
功能: Audio
AudioFilter:GetConnectedWires(pin:string):{Wire}
參數
pin:string
返回

GetGainAt
功能: Audio
AudioFilter:GetGainAt(frequency:number):number
參數
frequency:number
返回

GetInputPins
功能: Audio
AudioFilter:GetInputPins():{any}
返回

GetOutputPins
功能: Audio
AudioFilter:GetOutputPins():{any}
返回

活動
WiringChanged
功能: Audio
AudioFilter.WiringChanged(
connected:boolean, pin:string, wire:Wire, instance:Instance
參數
connected:boolean
pin:string
wire:Wire
instance:Instance

©2026 Roblox Corporation、Roblox、Roblox 標誌及 Powering Imagination 是我們在美國及其他國家地區的部分註冊與未註冊商標。