学ぶ
エンジンクラス
AudioFilter

*このコンテンツは、ベータ版のAI(人工知能)を使用して翻訳されており、エラーが含まれている可能性があります。このページを英語で表示するには、 こちら をクリックしてください。


概要
イベント
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は、米国並びにその他の国における登録商標および非登録商標です。