AudioListener
*Este contenido se traduce usando la IA (Beta) y puede contener errores. Para ver esta página en inglés, haz clic en aquí.
AudioListener registra un flujo de audio desde su entorno AudioEmitters en el mundo 3D.Proporciona un solo puerto de salida que se puede conectar a otros pines a través de .Si el padre es un , o , el mundo del padre se usará para escuchar.Si el padre no es una de estas Clases, el AudioListener efectivamente no escucha nada.
Muestras 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 = outputResumen
Propiedades
Representa cómo cambia el volumen percibido del sonido emitido en función del ángulo entre un AudioEmitter y el LookVector asociado con el AudioListener .
Controles que AudioEmitters son audibles para este AudioListener .
Representa cómo cambia el volumen percibido de los sonidos emitidos a medida que aumenta la distancia entre AudioEmitters y AudioListener.
Métodos
Obtiene la curva de atenuación de ángulo que el AudioListener está utilizando, o una tabla vacía si está utilizando la curva predeterminada.
Devuelve un array de Wires que están conectados al anclarespecificado.
Obtiene la curva de atenuación de distancia que el AudioListener está utilizando, o una tabla vacía si está utilizando la curva predeterminada.
Establece la curva de atenuación de ángulo que el AudioListener debería usar, o usa una curva constante de volumen 1 si no se proporciona ninguna.
Establece la curva de atenuación a distancia que el AudioListener debe usar, o usa una curva de desaparición inversa si no se proporciona ninguna.
Eventos
Se incendia cuando otra instancia se conecta o se desconecta del AudioListener a través de un Wire .
Propiedades
AngleAttenuation
Representa una curva de volumen sobre ángulo que afecta el volumen con el que un AudioListener escuchará al AudioEmitter , según el ángulo entre ellos y el LookVector asociado con el AudioListener .
Esta propiedad es interna y no se puede acceder a ella por medio de scripts; existe para apoyar la replicación. Vea SetAngleAttenuation() para detalles de uso.
AudioInteractionGroup
Controles que AudioEmitters son audibles para este AudioListener . Los emisores que comparten un grupo de interacción se pueden escuchar por este receptor.
DistanceAttenuation
Representa una curva de volumen a distancia que afecta el volumen con que se escucha cualquier , según la distancia entre ellos.
Esta propiedad es interna y no se puede acceder a ella por medio de scripts; existe para apoyar la replicación. Vea SetDistanceAttenuation() para detalles de uso.
SimulationFidelity
Métodos
GetAngleAttenuation
Devuelve un ángulo de mapeo de tabla al volumen.Las claves son números entre 0 y 180 (inclusivos), mientras que los valores son números entre 0 y 1 (inclusivos) que describen cómo se atenúa el volumen dependiendo de la dirección.Este método devuelve una tabla vacía si se está utilizando la curva de atenuación predeterminada del ángulo.
Devuelve
Angulo de mapeo de tabla al volumen, como se describe anteriormente.
GetConnectedWires
Devuelve un array de Wires que están conectados al anclarespecificado. AudioListener tiene un anclar"Salida".
Parámetros
Devuelve
GetDistanceAttenuation
Devuelve una distancia de mapeo de tabla a volumen.Las claves son números mayores o iguales a 0, mientras que los valores son números entre 0 y 1 (inclusivos) que describen cómo se atenúa el volumen a través de la distancia.Este método devuelve una tabla vacía si se está utilizando la curva de atenuación predeterminada de distancia.
Devuelve
GetInteractingEmitters
Devuelve
SetAngleAttenuation
Establece una curva de volumen sobre ángulo que afecta el volumen con el que un AudioListener escuchará al AudioEmitter , según el ángulo entre ellos y el LookVector asociado con el AudioListener .
La curva se representa con las teclas de mapeo de tabla para ángulos de volumen a valores de volumen.Se espera que las claves sean números únicos entre 0 y 180 (inclusivos), mientras que se espera que los valores sean números entre 0 y 1 (inclusivos).Se admiten tablas que contienen hasta 400 pares de clave-valor.
El volumen de un AudioEmitter desde la perspectiva del AudioListener en un ángulo a se determina al interpolar linealmente entre los niveles de volumen para los puntos de la curva cuyos valores de ángulo están directamente por encima y por debajo de a .Si no hay ningún punto por debajo de a o ningún punto por encima de a, se elige el nivel de volumen del otro punto.Esencialmente, la curva es una secuencia de puntos conectados por líneas rectas, y más allá de sus puntos de extremo izquierdo y derecho, la curva se extiende hacia afuera en sus respectivos niveles de volumen.
Este volumen se multiplicará con los volúmenes de todas las otras curvas de atenuación (incluidas las que están en el envío AudioEmitter ) para obtener la audibilidad final.
Si la tabla está vacía o nil , el AudioEmitter predeterminado utiliza una curva de atenuación de ángulo con el valor de volumen constante de 1 .
Parámetros
Devuelve
SetDistanceAttenuation
Establece una curva de volumen a distancia que afecta el volumen con que el AudioListener escuchará cualquier AudioEmitters, en función de la distancia entre ellos.
La curva se representa mediante las teclas de distancia de mapeo de una tabla a los valores de volumen.Se espera que las claves sean números únicos mayores o iguales a 0, mientras que los valores se esperan que sean números entre 0 y 1 (inclusivos).Se admiten tablas que contienen hasta 400 pares de clave-valor.
El volumen de un AudioEmitter desde la perspectiva del AudioListener a una distancia d se determina al interpolar linealmente entre los niveles de volumen para los puntos de la curva cuyos valores de distancia están directamente por encima y por debajo de d .Si no hay ningún punto por debajo de d o ningún punto por encima de d, se elige el nivel de volumen del otro punto.Esencialmente, la curva es una secuencia de puntos conectados por líneas rectas, y más allá de sus puntos de extremo izquierdo y derecho, la curva se extiende hacia afuera infinitamente en sus respectivos niveles de volumen.
Este volumen se multiplicará con los volúmenes de todas las otras curvas de atenuación (incluidas las que están en el envío AudioEmitter ) para obtener la audibilidad final.
Si la tabla está vacía o nil , el AudioListener predeterminado aplica un volumen constante de 1 en todas partes.
Parámetros
Devuelve
Eventos
WiringChanged
Evento que se activa después de que un Wire se conecte o se desconecte, y que Wire ahora está conectado o fue previamente conectado a un puerto en el AudioListener y a alguna otra instancia inalámbrica.
Parámetros
Si la instancia se conectó o se desconectó.
El puerto en el AudioListener que los objetivos Wire apuntan.
El Wire entre la AudioListener y la otra instancia.