AudioFilter

Mostrar obsoleto

*Este conteúdo é traduzido por IA (Beta) e pode conter erros. Para ver a página em inglês, clique aqui.

AudioFilter ajusta o conteúdo de frequência de feeds de áudio. Ele fornece um pino

Amostras de código

An AudioFilter can be used to change the frequency content of audio streams. In this example, an AudioFilter is used to make the AudioEmitter output more muffled when there's a wall between it and the AudioListener.

Emitter Filtering

-- This assumes the workspace contains a Part with an AudioEmitter and an AudioPlayer, and the camera has an 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
-- Create a new AudioFilter
local filter: AudioFilter = Instance.new("AudioFilter")
filter.FilterType = Enum.AudioFilterType.Lowpass12dB
filter.Frequency = 22000
filter.Q = math.sqrt(2) / 2 -- This Q value produces a flat lowpass for the 12dB slope type
filter.Parent = part
-- Put the AudioFilter between the player and the 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)
-- Update the filter based on the positions of the emitter and 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)

Resumo

Propriedades

  • Ler Parallel

    Se as transmissões de áudio são passadas através de efeitos não afetados por este efeito.

  • Não replicado
    Segurança do script Roblox
    Ler Parallel
  • O tipo de curva representado pelo filtro.

  • Ler Parallel

    A frequência central que o filtro age em torno.

  • Ler Parallel

    Para filtros de topo e prateleiras, controla o volume de entrada ou saída.

  • Ler Parallel

    Para peaking, lowpass, highpass, bandpass e notch filters, controla a seleção ou a ressonância.

Métodos

Propriedades

Bypass

Ler Parallel

Se true , stream de áudio são pass-through sem efeito por este efeito.

Editor

Não replicado
Segurança do script Roblox
Ler Parallel
Ler Parallel

O tipo de resposta de frequência que será usado para filtrar o sinal de áudio. Cada tipo de curva afeta o conteúdo de frequência do áudio de diferentes maneiras.

Frequency

Ler Parallel

A frequência central em hertz da curva representada pelo filtro. Normalmente, ajustar este valor para cima ou para baixo corresponde a um deslocamento horizontal na curva de frequência geral. Vários de 20 a 22000.

Gain

Ler Parallel

O valor de ganho em decímetros usado para determinar o nível de volume da curva representada pelo filtro. Aplica-se somente quando o FilterType estiver Peak, LowShelf ou 2>HighShelf2>. As faixas variam de -30 a 30.

Ler Parallel

O valor de qualidade usado para determinar a inclinação ou ressonância da curva representada pelo filtro. Aplica-se somente quando o FilterType estiver Peak, Lowpass[x]dB, 2>Highpass[x]dB2>, 5>Bandpass5> ou

Para valores de FilterType de Lowpass12dB e Highpass12dB, um valor de 1>Q</

Métodos

GetConnectedWires

Instances

Retorna um array de Wires que estão conectados ao marcarespecificado. AudioFilter tem um pino "Entrada" e um marcar"Saída".

Parâmetros

pin: string

Devolução

Instances

GetGainAt

Retorna o valor de ganho, em decíbeis, da curva de resposta de frequência representada pelo filtro na frequência fornecida, em hertz. Isso pode ser usado para amostrar a forma exata do filtro em locais-chave ou como um todo.

Parâmetros

frequency: number

A frequência, em hertz, para amostrar.


Devolução

O valor de ganho, em decíbeis, na frequência fornecida.

Eventos