AudioFilter
*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 streams de áudio.Ele fornece um pino de entrada e um pino de saída que podem ser conectados a/de .AudioFilter usa suas propriedades FilterType , Gain e Q para determinar o que fazer em torno de um corte específico Frequency .
Amostras de código
-- 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
Se os fluxos de áudio são transmitidos sem serem afetados por esse efeito.
O tipo de curva da banda representada pelo filtro.
A frequência central em que o filtro atua ao redor.
Para filtros de pico e estante, os controles aumentam ou reduzem o volume.
Para picos, baixos, altos, bandpass e filtros de notch, controla a selecionalidade ou ressonância.
Métodos
Retorna um array de Wires que estão conectados ao pino especificado.
Retorna a resposta de magnitude do filtro na frequência dada.
Eventos
Incêndios quando outra instância está conectada ou desconectada do AudioFilter através de um Wire .
Propriedades
Editor
FilterType
O tipo de curva de resposta de frequência que será usada para filtrar o sinal de áudio.Cada tipo de curva afeta o conteúdo de frequência do áudio de maneiras diferentes.
Frequency
A frequência central em hertz da curva representada pelo filtro.Em geral, ajustar esse valor para cima ou para baixo corresponde a um deslocamento horizontal na curva de frequência geral.Vários de 20 a 22000.
Gain
O ganho em decibéis usado para determinar o nível de volume da curva representada pelo filtro.Aplica-se somente quando o FilterType é Peak, LowShelf ou HighShelf.Vários de -30 a 30.
O valor de qualidade usado para determinar a inclinação ou ressonância da curva representada pelo filtro.Aplica-se somente quando o FilterType é Peak , Lowpass[x]dB , Highpass[x]dB , Bandpass ou Notch .Vários de 0.1 a 10.
Para FilterType valores de Lowpass12dB e Highpass12dB , um valor de Q de sqrt(2) / 2 ou 0.707 corresponde a um filtro plano em um declive de 12dB/octava.
Métodos
GetConnectedWires
Retorna um array de Wires que estão conectados ao pino especificado. AudioFilter tem um pino "Entrada" e um pino "Saída".
Parâmetros
Devolução
GetGainAt
Retorna o valor de ganho, em decibéis, da curva de resposta de frequência representada pelo filtro na frequência dada, em hertz.Isso pode ser usado para amostrar a forma exata do filtro em locais-chave ou como um todo.
Parâmetros
A frequência, em hertz, para amostrar.
Devolução
O ganho de valor, em decibéis, na frequência dada.
Eventos
WiringChanged
Evento que dispara depois que um Wire se conecta ou se desconecta, e que Wire está agora conectado ou foi previamente conectado a um pino no AudioFilter e a alguma outra instância viável.
Parâmetros
Se a instância se conectou ou desconectou.
O pino no AudioFilter que os alvos Wire alvo.
O Wire entre a AudioFilter e a outra instância.