배우기
엔진 클래스
AudioFilter

*이 콘텐츠는 AI(베타)를 사용해 번역되었으며, 오류가 있을 수 있습니다. 이 페이지를 영어로 보려면 여기를 클릭하세요.


코드 샘플
발산기 필터링
-- 이 코드는 작업공간에 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'은 미국 및 기타 국가 내 당사의 등록 및 미등록 상표입니다.