로블록스 공간 오디오 폐색: 동적 레이캐스팅, 음향 잔향 구역 및 로우패스 감쇄 필터링

--!strict
local Workspace = game:GetService("Workspace")
local RunService = game:GetService("RunService")

local OcclusionManager = {}
OcclusionManager.__index = OcclusionManager

export type TrackedEmitter = {
    Sound: Sound,
    Attachment: Attachment,
    Equalizer: EqualizerSoundEffect,
    CurrentGain: number,
    MaxDistance: number,
    Priority: number
}

local raycastParams = RaycastParams.new()
raycastParams.FilterType = RaycastFilterType.Exclude
raycastParams.IgnoreWater = true

local trackedSounds: { [Sound]: TrackedEmitter } = {}
local camera = Workspace.CurrentCamera

function OcclusionManager.RegisterSound(sound: Sound, attachment: Attachment, maxDistance: number, priority: number)
    local eq = sound:FindFirstChildOfClass("EqualizerSoundEffect")
    if not eq then
        eq = Instance.new("EqualizerSoundEffect")
        eq.HighGain = 0
        eq.MidGain = 0
        eq.LowGain = 0
        eq.Priority = 1
        eq.Parent = sound
    end

    trackedSounds[sound] = {
        Sound = sound,
        Attachment = attachment,
        Equalizer = eq,
        CurrentGain = 0,
        MaxDistance = maxDistance,
        Priority = priority
    }
end

function OcclusionManager.UnregisterSound(sound: Sound)
    trackedSounds[sound] = nil
end

local function CalculateOcclusion(origin: Vector3, target: Vector3, charModel: Model?): (boolean, number)
    local direction = target - origin
    local distance = direction.Magnitude
    if distance <= 0.5 then return false, 0 end

    local filterList = { camera }
    if charModel then table.insert(filterList, charModel) end
    raycastParams.FilterDescendantsInstances = filterList

    local result = Workspace:Raycast(origin, direction, raycastParams)
    if result and result.Instance then
        local hitDist = (result.Position - origin).Magnitude
        if hitDist < (distance - 0.5) then
            local material = result.Material
            local densityFactor = 1.0
            if material == Enum.Material.Wood or material == Enum.Material.WoodPlanks then
                densityFactor = 0.5
            elseif material == Enum.Material.Glass then
                densityFactor = 0.3
            elseif material == Enum.Material.Metal or material == Enum.Material.DiamondPlate then
                densityFactor = 1.4
            end
            return true, densityFactor
        end
    end
    return false, 0
end

local frameCount = 0
RunService.RenderStepped:Connect(function(dt: number)
    frameCount += 1
    local listenerPos = camera.CFrame.Position
    local char = game.Players.LocalPlayer.Character

    for sound, emitter in pairs(trackedSounds) do
        if not sound.IsPlaying or not emitter.Attachment.Parent then
            continue
        end

        local emitterPos = emitter.Attachment.WorldPosition
        local dist = (emitterPos - listenerPos).Magnitude
        if dist > emitter.MaxDistance then continue end

        -- 거리에 따른 라운드로빈 부하 분산
        if dist > 60 and (frameCount % 4 ~= 0) then continue end
        if dist > 30 and (frameCount % 2 ~= 0) then continue end

        local isOccluded, density = CalculateOcclusion(listenerPos, emitterPos, char)
        local targetHighGain = isOccluded and (-32 * density) or 0
        local targetMidGain = isOccluded and (-12 * density) or 0

        -- 로우패스 감쇄 보간
        emitter.Equalizer.HighGain += (targetHighGain - emitter.Equalizer.HighGain) * math.clamp(dt * 12, 0, 1)
        emitter.Equalizer.MidGain += (targetMidGain - emitter.Equalizer.MidGain) * math.clamp(dt * 12, 0, 1)
    end
end)

return OcclusionManager