AudioListener

Mostrar obsoleto

*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

Camera Listener

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 = output

Resumo

Propriedades

Métodos

Eventos

Propriedades

AngleAttenuation

BinaryString
Segurança Roblox
Ler Parallel

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

Ler Parallel

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

BinaryString
Segurança Roblox
Ler Parallel

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.

Ler Parallel

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

Parâmetros

emitter: AudioEmitter
Valor Padrão: ""

Devolução

GetConnectedWires

Instances

Retorna um array de Wires que estão conectados ao marcarespecificado. AudioListener tem um marcar"Saída".

Parâmetros

pin: string
Valor Padrão: ""

Devolução

Instances

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

GetInputPins


Devolução

GetInteractingEmitters

Instances

Devolução

Instances

GetOutputPins


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

curve: Dictionary
Valor Padrão: ""

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

curve: Dictionary
Valor Padrão: ""

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

connected: boolean

Se a instância se conectou ou desconectou.

pin: string

O pino no AudioListener que os alvos Wire alvo.

wire: Wire

O Wire entre a AudioListener e a outra instância.

instance: Instance

A outra instância que está ou esteve conectada através do Wire .