AudioListener
*Ce contenu est traduit en utilisant l'IA (Beta) et peut contenir des erreurs. Pour consulter cette page en anglais, clique ici.
AudioListener enregistre un flux audio de son environnement AudioEmitters dans le monde 3D.Il fournit un seul sortie pin qui peut être connecté à d'autres pins via Wires.Si le parent est un , ou , le monde du parent sera utilisé pour l'écoute.Si le parent n'est pas l'une de ces Classes, le AudioListener n'entend effectivement rien.
Échantillons de code
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 = outputRésumé
Propriétés
Représente la façon dont le volume perçu du son émis change en fonction de l'angle entre un AudioEmitter et le LookVector associé au AudioListener.
Contrôles qui sont audibles pour ce .
Représente la façon dont le volume perçu des sons émis change à mesure que la distance entre AudioEmitters et AudioListener augmente.
Méthodes
Obtient la courbe d'atténuation d'angle que l'élément AudioListener utilise, ou une table vide si elle utilise la courbe par défaut.
Renvoie un tableau de Wires qui sont connectés au épinglerspécifié.
Obtient la courbe d'atténuation de distance que l'élément AudioListener utilise, ou une table vide si elle utilise la courbe par défaut.
Définit la courbe d'atténuation de l'angle que le AudioListener devrait utiliser, ou utilise une courbe constante de volume 1 si aucune n'est fournie.
Définit la courbe d'atténuation de distance que le AudioListener doit utiliser, ou utilise une courbe d'atténuation inversée si aucune n'est fournie.
Évènements
Se déclenche lorsqu'une autre instance est connectée ou déconnectée du AudioListener via un Wire .
Propriétés
AngleAttenuation
Représente une courbe volume-sur-angle qui affecte la façon dont un AudioListener entendra fortement le AudioEmitter , en fonction de l'angle entre eux et du LookVector associé au AudioListener .
Cette propriété est interne et ne peut pas être accessible par des scripts ; elle existe pour soutenir la réplication. Voir SetAngleAttenuation() pour les détails d'utilisation.
AudioInteractionGroup
Contrôles qui sont audibles pour ce AudioEmitters . Les émetteurs qui partagent un groupe d'interaction peuvent être entendus par ce AudioListener .
DistanceAttenuation
Représente une courbe de volume à distance qui affecte la façon dont le AudioListener entend n'importe quel AudioEmitters, en fonction de la distance entre eux.
Cette propriété est interne et ne peut pas être accessible par des scripts ; elle existe pour soutenir la réplication. Voir SetDistanceAttenuation() pour les détails d'utilisation.
SimulationFidelity
Méthodes
GetAngleAttenuation
Renvoie un angle de mapping de table au volume.Les clés sont des nombres entre 0 et 180 (inclus), tandis que les valeurs sont des nombres entre 0 et 1 (inclus) décrivant comment le volume s'atténue en fonction de la direction.Cette méthode renvoie une table vide si la courbe d'atténuation de l'angle par défaut est utilisée.
Retours
Angle de mapping de table vers le volume, comme décrit ci-dessus.
GetConnectedWires
Retourne un tableau de Wires qui sont connectés au épinglerspécifié. AudioListener a un épingler« Sortie ».
Paramètres
Retours
GetDistanceAttenuation
Renvoie une distance de mapping de table vers le volume.Les clés sont des nombres supérieurs ou égaux à 0, tandis que les valeurs sont des nombres entre 0 et 1 (inclus) décrivant comment le volume s'atténue à distance.Cette méthode renvoie une table vide si la courbe de réduction de distance par défaut est utilisée.
Retours
GetInteractingEmitters
Retours
SetAngleAttenuation
Définit une courbe de volume par rapport à l'angle qui affecte la façon dont un AudioListener entendra fortement le AudioEmitter , en fonction de l'angle entre eux et du LookVector associé au AudioListener .
La courbe est représentée par des clés de mapping de table pour les valeurs de volume.Les clés sont attendues comme des nombres uniques entre 0 et 180 (inclus), tandis que les valeurs sont attendues comme des nombres entre 0 et 1 (inclus).Les tables contenant jusqu'à 400 paires clé-valeur sont prises en charge.
Le volume d'un AudioEmitter à partir de la perspective du AudioListener à un angle a est déterminé par l'interpolation linéaire entre les niveaux de volume pour les points sur la courbe dont les valeurs d'angle sont directement au-dessus et en dessous de a .S'il n'y a pas de point au-dessous de a ou de point au-dessus de a, le niveau de volume de l'autre point est choisi.Fondamentalement, la courbe est une séquence de points connectés par des lignes droites, et au-delà de ses extrémités gauche et droite, la courbe s'étend vers l'extérieur à leurs niveaux de volume respectifs.
Ce volume sera multiplié par les volumes de toutes les autres courbes d'atténuation (y compris ceux sur l'envoi AudioEmitter ) pour obtenir l'audibilité finale.
Si la table est vide ou nil , le AudioEmitter défaut utilise une courbe d'atténuation d'angle avec la valeur de volume constant de 1 .
Paramètres
Retours
SetDistanceAttenuation
Définit une courbe de volume à distance qui affecte la façon dont le AudioListener entendra fortement n'importe quel AudioEmitters, en fonction de la distance entre eux.
La courbe est représentée par des clés de distance de mapping de table vers des valeurs de volume.Les clés sont attendues comme des nombres uniques supérieurs ou égaux à 0, tandis que les valeurs sont attendues comme des nombres entre 0 et 1 (inclusifs).Les tables contenant jusqu'à 400 paires clé-valeur sont prises en charge.
Le volume d'un AudioEmitter à partir de la perspective du AudioListener à une distance d est déterminé par l'interpolation linéaire entre les niveaux de volume pour les points sur la courbe dont les valeurs de distance sont directement au-dessus et en dessous de d .S'il n'y a pas de point au-dessous de d ou de point au-dessus de d, le niveau de volume de l'autre point est choisi.Fondamentalement, la courbe est une séquence de points connectés par des lignes droites, et au-delà de ses extrémités gauche et droite, la courbe s'étend à l'infini vers l'extérieur à leur niveau de volume respectif.
Ce volume sera multiplié par les volumes de toutes les autres courbes d'atténuation (y compris ceux sur l'envoi AudioEmitter ) pour obtenir l'audibilité finale.
Si la table est vide ou nil , le AudioListener défaut applique une constante volume de 1 partout.
Paramètres
Retours
Évènements
WiringChanged
Événement qui se déclenche après qu'un Wire devienne connecté ou déconnecté, et que Wire soit maintenant ou ait été précédemment connecté à un bouton sur le AudioListener et à une autre instance wirable.
Paramètres
Si l'instance s'est connectée ou déconnectée.
L'épingle sur le AudioListener que les cibles Wire .
Le Wire entre la AudioListener et l'autre instance.