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 depuis son monde Class.AudioEmitter
É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 = output
Résumé
Propriétés
Représente comment le volume perçu du son émis change en fonction de l'angle entre un AudioEmitter et un LookVector associé avec le AudioListener.
Contrôles que AudioEmitters sont audibles pour ce AudioListener .
Représente comment le volume perçu des sons émis change en fonction de la distance entre AudioEmitters et AudioListener augmentant.
Méthodes
Obtient la courbe d'atténuation d'angle que l' AudioListener utilise, ou une table vide si elle utilise la courbe par défaut.
Retourne un tableau de Wires qui sont connectés à l'épinglerspécifié.
Obtient la courbe de réduction de distance que l' AudioListener utilise, ou une table vide si elle utilise la courbe par défaut.
Définit la courbe d'atténuation d'angle que le AudioListener doit utiliser, ou utilise une courbe de volume constante 1 si aucune n'est fournie.
Définit la courbe d'atténuation de distance que le AudioListener doit utiliser, ou utilise une courbe de roulis inversé si aucune n'est fournie.
Propriétés
AngleAttenuation
Représente une courbe de volume au-dessus de l'angle qui affecte le volume d'un AudioListener , en fonction de l'angle entre eux et le AudioEmitter associé au LookVector .
Cette propriété est interne et ne peut pas être utilisée par les scripts ; elle existe pour prendre en charge la réplication. Voir SetAngleAttenuation() pour plus de détails d'utilisation.
AudioInteractionGroup
Contrôles qui AudioEmitters sont audibles pour ce AudioListener . Les émetteurs qui partagent un groupe d'interaction peuvent être entendus par ce Listener.
DistanceAttenuation
Représente une courbe de volume-sur-距離 qui affecte le volume de l'AudioListener qui entend n'importe lequel des AudioEmitters , en fonction de la distance entre eux.
Cette propriété est interne et ne peut pas être accessible par les scripts ; elle existe pour prendre en charge la réplication. Voir SetDistanceAttenuation() pour plus de détails d'utilisation.
Méthodes
GetAngleAttenuation
Renvoie un angle de mise en relation de table au volume. Les clés sont des numéros entre 0 et 180 (inclusif), alors que les valeurs sont des numéros entre 0 et 1> 11> (inclusif) décrivant comment la mise en relation du volume varie en fonction de la direction. Ce méthode renvoie une table vide si la courbe d'angle par défaut est utilis
Retours
Angle de mise à l'échelle de la table pour le volume, comme décrit ci-dessus.
GetConnectedWires
Retourne un tableau de Wires qui sont connectés à l'épinglerspécifié. AudioListener a un seul « Output » épingler.
Paramètres
Retours
GetDistanceAttenuation
Renvoie une distance de table de mise en volume. Les clés sont des nombres supérieurs ou égaux à 0, tandis que les valeurs sont des nombres entre 0 et 1 (y compris) décrivant comment le volume s'atténue au fil du temps. Cette méthode renvoie une table vide si la courbe d'atténuation de distance par défaut est utilisée.
Retours
GetInteractingEmitters
Retours
SetAngleAttenuation
Définit une courbe de volume-over-angle qui affecte le volume d'une AudioListener , basé sur l'angle entre eux et le AudioEmitter associé avec le LookVector .
La courbe est représentée par une table de mise en relation des angles des clés des valeurs de volume. Les clés sont attendues d'être des numéros uniques entre 0 et 180 (inclusif), alors que les valeurs sont attendues d'être des numéros entre 0 et 1> 11> (inclusif). Les tables contenant jusqu'à 400 paires de clés de vale
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
Ce volume sera multiplié par le volume des autres courbes d'atténération (y compris ceux sur l'envoi AudioEmitter ) pour obtenir la finalité d'audibilité.
Si la table est vide ou nil, le AudioEmitter par défaut utilise une courbe d'atténuation d'angle avec la valeur de volume constante de 1.
Paramètres
Retours
SetDistanceAttenuation
Définit une courbe de volume-over-Distance qui affecte la force de l'écoute du AudioListener , basée sur la distance entre eux.
La courbe est représentée par des clés de table de distance de mise en relation avec les valeurs de volume. Les clés sont attendues d'être des numéros uniques supérieurs à ou égaux à 0, tandis que les valeurs sont attendues d'être des nombres entre 0 et 1 (y compris). Les tables contenant jusqu'à 400 paires de clés de 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
Ce volume sera multiplié par le volume des autres courbes d'atténération (y compris ceux sur l'envoi AudioEmitter ) pour obtenir la finalité d'audibilité.
Si la table est vide ou nil, le AudioListener par défaut s'applique à appliquer une volumétal constante de 1 partout.