Ghi chú phát hành
Học
Lớp công cụ
AudioFilter

*Nội dung này được dịch bằng AI (Beta) và có thể có lỗi. Để xem trang này bằng tiếng Anh, hãy nhấp vào đây.


Tóm Tắt
Sự Kiện
WiringChanged(connected: boolean,pin: string,wire: Wire,instance: Instance):RBXScriptSignal
Thành viên kế thừa
Mẫu mã
Lọc Emitter
-- Điều này giả định rằng workspace chứa một Part với một AudioEmitter và một AudioPlayer, và camera có một 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
-- Tạo một AudioFilter mới
local filter: AudioFilter = Instance.new("AudioFilter")
filter.FilterType = Enum.AudioFilterType.Lowpass12dB
filter.Frequency = 22000
filter.Q = math.sqrt(2) / 2 -- Giá trị Q này tạo ra một lowpass phẳng cho loại độ dốc 12dB
filter.Parent = part
-- Đặt AudioFilter giữa người chơi và emitter
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)
-- Cập nhật bộ lọc dựa trên vị trí của emitter và listener
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)

Tài Liệu Tham Khảo API
Thuộc Tính
Bypass
Đọc Song Song
Các khả năng: Audio
AudioFilter.Bypass:boolean

FilterType
Đọc Song Song
Các khả năng: Audio
AudioFilter.FilterType:Enum.AudioFilterType

Frequency
Đọc Song Song
Các khả năng: Audio
AudioFilter.Frequency:number

Gain
Đọc Song Song
Các khả năng: Audio
AudioFilter.Gain:number

Q
Đọc Song Song
Các khả năng: Audio
AudioFilter.Q:number

Phương Pháp
GetConnectedWires
Các khả năng: Audio
AudioFilter:GetConnectedWires(pin:string):{Wire}
Tham Số
pin:string
Lợi Nhuận

GetGainAt
Các khả năng: Audio
AudioFilter:GetGainAt(frequency:number):number
Tham Số
frequency:number
Lợi Nhuận

GetInputPins
Các khả năng: Audio
AudioFilter:GetInputPins():{any}
Lợi Nhuận

GetOutputPins
Các khả năng: Audio
AudioFilter:GetOutputPins():{any}
Lợi Nhuận

Sự Kiện
WiringChanged
Các khả năng: Audio
AudioFilter.WiringChanged(
connected:boolean, pin:string, wire:Wire, instance:Instance
Tham Số
connected:boolean
pin:string
wire:Wire
instance:Instance

©2026 Roblox Corporation. Roblox, logo Roblox và Powering Imagination là các nhãn hiệu đã đăng ký và chưa đăng ký của chúng tôi tại Hoa Kỳ và các quốc gia khác.