AudioListener
*Este conteúdo é traduzido por IA (Beta) e pode conter erros. Para ver a página em inglês, clique aqui.
AudioListener grava um fluxo de áudio de seu entorno AudioEmitters no mundo 3D.Ele fornece um único pino Saída que pode ser conectado a outros pinos através de Wires .Se o pai for um , ou , o mundo do pai será usado para escuta.Se o pai não for uma dessas classes, o AudioListener ouve efetivamente nada.
Amostras de código
local listener = Instance.new("AudioListener")
local output = Instance.new("AudioDeviceOutput")
local wire = Instance.new("Wire")
listener.Parent = workspace.Camera
wire.Parent = listener
output.Parent = wire
wire.SourceInstance = listener
wire.TargetInstance = outputResumo
Propriedades
Representa como o volume percebido do som emitido muda com base no ângulo entre um AudioEmitter e o LookVector associado ao AudioListener.
Controles que AudioEmitters são audíveis para este AudioListener .
Representa como o volume percebido de sons emitidos muda à medida que a distância entre AudioEmitters e o AudioListener aumenta.
Controla o quão detalhada a simulação de áudio deve ser para este AudioListener .
Métodos
Obtém a curva de atenuação de ângulo que o AudioListener está usando ou uma tabela vazia se estiver usando a curva padrão.
Calcula quão audível é um AudioEmitter para este ouvinte
Retorna um array de Wires que estão conectados ao pino especificado.
Obtém a curva de atenuação de distância que o AudioListener está usando, ou uma tabela vazia se estiver usando a curva padrão.
Lista tudo AudioEmitters que este ouvinte é capaz de ouvir.
Define a curva de atenuação de ângulo que o AudioListener deve usar ou usa uma curva constante de volume 1 se nenhuma for fornecida.
Define a curva de atenuação de distância que o AudioListener deve usar ou usa uma curva de rolamento inverso se nenhuma for fornecida.
Eventos
Incêndios quando outra instância está conectada ou desconectada do AudioListener através de um Wire .
Propriedades
AngleAttenuation
Representa uma curva de volume sobre ângulo que afeta o quão alto um AudioListener ouvirá o AudioEmitter , com base no ângulo entre eles e o LookVector associado ao AudioListener .
Esta propriedade é interna e não pode ser acessada por scripts; ela existe para suportar a replicação. Veja SetAngleAttenuation() para detalhes de uso.
AudioInteractionGroup
Controles que AudioEmitters são audíveis para este AudioListener . Emissores que compartilham um grupo de interação podem ser ouvidos por este ouvinte.
DistanceAttenuation
Representa uma curva de volume-em-distância que afeta como alto o AudioListener ouve qualquer AudioEmitters, com base na distância entre eles.
Esta propriedade é interna e não pode ser acessada por scripts; ela existe para suportar a replicação. Veja SetDistanceAttenuation() para detalhes de uso.
SimulationFidelity
Controla o quão detalhada a simulação de áudio deve ser para este AudioListener, semelhante a MeshPart.CollisionFidelity ou MeshPart.RenderFidelity.
AudioListeners e AudioEmitters que discordam sobre o nível de detalhe necessário usarão a opção menos detalhada.
Métodos
GetAngleAttenuation
Retorna um ângulo de mapeamento de tabela para volume.Chaves são números entre 0 e 180 (inclusivo), enquanto os valores são números entre 0 e 1 (inclusivo) descrevendo como o volume atenua dependendo da direção.Este método retorna uma tabela vazia se a curva de atenuação de ângulo padrão estiver sendo usada.
Devolução
Ângulo de mapeamento de tabela para volume, como descrito acima.
GetAudibilityFor
Calcula quão audível é um AudioEmitter para este ouvinte.O volume resultante, que varia de 0 a 1, representa a atenuação de distância e ângulo em ambos o emissor e o receptor.
Parâmetros
Devolução
GetConnectedWires
Retorna um array de Wires que estão conectados ao pino especificado. AudioListener tem um pino "Saída".
Parâmetros
Devolução
GetDistanceAttenuation
Retorna uma distância de mapeamento de tabela para volume.Chaves são números maiores ou iguais a 0, enquanto os valores são números entre 0 e 1 (inclusivo) descrevendo como o volume se atenua à distância.Este método retorna uma tabela vazia se a curva de atenuação padrão de distância estiver sendo usada.
Devolução
GetInteractingEmitters
Retorna um array de AudioEmitters que compartilha um AudioInteractionGroup com o ouvinte.
Devolução
SetAngleAttenuation
Define uma curva de volume sobre ângulo que afeta como alto um AudioListener ouvirá o AudioEmitter , com base no ângulo entre eles e o LookVector associado ao AudioListener .
A curva é representada por chaves de mapeamento de tabela para valores de volume.As chaves são esperadas ser números únicos entre 0 e 180 (inclusivo), enquanto os valores são esperados ser números entre 0 e 1 (inclusivo).Tabelas que contêm até 400 pares de chave-valor são suportadas.
O volume de um AudioEmitter a partir da perspectiva do AudioListener em um ângulo a é determinado pela interpolação linear entre os níveis de volume para os pontos na curva cujos valores de ângulo estão diretamente acima e abaixo de a .Se não há nenhum ponto abaixo de a ou nenhum ponto acima de a, o nível de volume do outro ponto é escolhido.Basicamente, a curva é uma sequência de pontos conectados por linhas retas, e além de seus pontos de extremidade esquerdo e direito, a curva se estende para fora em seus respectivos níveis de volume.
Este volume será multiplicado com os volumes de todas as outras curvas de atenuação (incluindo as que estão no envio AudioEmitter ) para obter a audibilidade final.
Se a tabela estiver vazia ou nil , o AudioEmitter padrão é usar uma curva de atenuação de ângulo com o valor constante de volume de 1 .
Parâmetros
Devolução
SetDistanceAttenuation
Define uma curva de volume por distância que afeta como alto o AudioListener ouvirá qualquer AudioEmitters, com base na distância entre eles.
A curva é representada por chaves de mapeamento de tabela para valores de volume.As chaves são esperadas ser números únicos maiores que ou igual a 0, enquanto os valores são esperados ser números entre 0 e 1 (inclusivo).Tabelas que contêm até 400 pares de chave-valor são suportadas.
O volume de um AudioEmitter a partir da perspectiva do AudioListener a uma distância d é determinado pela interpolação linear entre os níveis de volume para os pontos na curva cujos valores de distância estão diretamente acima e abaixo de d .Se não há nenhum ponto abaixo de d ou nenhum ponto acima de d, o nível de volume do outro ponto é escolhido.Basicamente, a curva é uma sequência de pontos conectados por linhas retas, e além de seus pontos de extremidade esquerda e direita, a curva se estende infinitamente para fora em seus respectivos níveis de volume.
Este volume será multiplicado com os volumes de todas as outras curvas de atenuação (incluindo as que estão no envio AudioEmitter ) para obter a audibilidade final.
Se a tabela estiver vazia ou nil , o AudioListener padrão é aplicar uma constante volume de 1 em todos os lugares.
Parâmetros
Devolução
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 AudioListener e a alguma outra instância viável.
Parâmetros
Se a instância se conectou ou desconectou.
O pino no AudioListener que os alvos Wire alvo.
O Wire entre a AudioListener e a outra instância.