AudioListener
*このコンテンツは、ベータ版のAI(人工知能)を使用して翻訳されており、エラーが含まれている可能性があります。このページを英語で表示するには、 こちら をクリックしてください。
AudioListener は、3D ワールドの周囲の AudioEmitters からオーディオストリームを記録します。他のピンに接続できる単一の 出力 ピンを提供します。Wires を介して他のピンに接続できます。親が Attachment 、Camera 、または PVInstance の場合、親の世界 CFrame がリスニングに使用されます。親がこれらのクラスの 1 つでない場合、AudioListener は効果的に何も聞かない。
コードサンプル
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
概要
プロパティ
放射された音の感じられる音量が、AudioEmitter と関連する角度に基づいて変化する方法を表示します。Represents how the perceived volume of the emitted sound changes based on the angle between a and the LookVector associated with the AudioListener .
この に聞こえるコントロール。
発射された音の感じられる量が、AudioEmitters と AudioListener の距離が増加するにつれてどのように変化するかを表します。
方法
AudioListener が使用している角減衰曲線を取得するか、デフォルトの曲線を使用している場合は空のテーブル。
指定されたピンに接続された Wires のアレイを返します。
AudioListener が使用している距離衰減曲線またはデフォルトの曲線を使用している場合は空のテーブルを取得します。
が使用するべき角減衰曲線を設定するか、提供されない場合はボリュームの定数曲線を使用します。
AudioListener が使用する距離衰減曲線を設定するか、提供されない場合は逆のロールオフ曲線を使用します。
イベント
別のインスタンスが を介して接続されたり、切断されたりしたときに発火します。
プロパティ
AngleAttenuation
Represents a volume-over-angle curve that affects how loudly a AudioListener will hear the AudioEmitter , based on the angle between them and the LookVector 関連する AudioListener .
このプロパティは内部であり、スクリプトでアクセスできません;レプリケーションをサポートするために存在します。使用詳細は、SetAngleAttenuation() を参照してください。
DistanceAttenuation
彼らの間の距離に基づいて、 がどれほど大声で聞こえるかに影響を与えるボリューム-オーバー-ディスタンス曲線を表示します。
このプロパティは内部であり、スクリプトでアクセスできません;レプリケーションをサポートするために存在します。使用詳細は、SetDistanceAttenuation() を参照してください。
SimulationFidelity
方法
GetAngleAttenuation
テーブルマッピング角をボリュームに返します。キーは 0 と 180 (含む)の間の数字であり、値は 0 と 1 (含む)の間の数字で、ボリュームが方向に応じて衰減する方法を説明します。このメソッドは、デフォルトの角消去曲線が使用されている場合、空のテーブルを返します。
戻り値
上記のように、テーブルマッピング角をボリュームにマッピングします。
GetConnectedWires
指定されたピピン留めに接続された Wires のアレイを返します。AudioListener には「出力」ピン留めが 1 つあります。
パラメータ
戻り値
GetDistanceAttenuation
テーブルマッピング距離をボリュームに返す。キーは 0 より大きいまたは等しい数字であり、値は 0 から 1(含む)の間の数字で、ボリュームが距離を通じて衰減する方法を説明します。このメソッドは、デフォルトの距離衰減曲線が使用されている場合、空のテーブルを返します。
戻り値
GetInteractingEmitters
戻り値
SetAngleAttenuation
[角度] と [角度] の間の角度に基づいて、AudioListener が AudioEmitter をどれほど大声で聞くかに影響を与える音量-角度曲線を設定します。これは、LookVector と関連付けられた AudioListener に基づいています。
カーブは、テーブルマッピング角キーをボリューム値にマッピングして表現されます。キーは 0 と 180 (含む)の間のユニークな数字であることが期待され、値は 0 と 1 (含む)の間の数字であることが期待されます。最大 400のキーバリューペアを含むテーブルがサポートされます。
からの角度の曲線のポイントのボリュームレベルの線形インターポレーションにより、角度値が直接上下にある曲線のポイントのボリュームレベルの間で線形インターポレーションにより決定されます。下の a または上の a にポイントがない場合、他のポイントのボリュームレベルが選択されます。本質的に、カーブは直線で結ばれたポイントの連続体であり、左右の端点を超えて、それぞれのボリュームレベルでカーブが外側に広がります。
このボリュームは、すべての他の衰減曲線 (送信 AudioEmitter を含む) のボリュームと乗算されて、最終的な聴覚を得ることになります。
テーブルが空または である場合、 は、定期的なボリューム値の角減衰曲線を使用するようにデフォルト設定されます。
パラメータ
戻り値
SetDistanceAttenuation
彼らの間の距離に基づいて、どれほど大声で が聞こえるかに影響を与えるボリューム-オーバー-距離曲線を設定します。
カーブは、テーブルマッピング距離キーをボリューム値にマップすることで表現されます。キーは 0 より大きいか等しいユニークな数字であることが期待され、値は 0 から 1(含む)の間の数字であることが期待されます。最大 400のキーバリューペアを含むテーブルがサポートされます。
からの距離の曲線のポイントのボリュームレベルの線形インターポレーションにより、 からの距離値が直接上下にある曲線のポイントのボリュームレベルの線形インターポレーションにより、ボリュームの量が決定されます。下の d または上の d にポイントがない場合、他のポイントのボリュームレベルが選択されます。本質的に、カーブは直線で結ばれたポイントの連続であり、左右の端点を超えて、それぞれのボリュームレベルで無限に外側に広がります。
このボリュームは、すべての他の衰減曲線 (送信 AudioEmitter を含む) のボリュームと乗算されて、最終的な聴覚を得ることになります。
テーブルが空または nil である場合、AudioListener はすべてに一定のボリュームを適用するようにデフォルト設定されます。
パラメータ
戻り値
イベント
WiringChanged
Wire が接続または切断された後に発生するイベント、および Wire が現在または以前に AudioListener および他のワイヤー可能なインスタンスのピンに接続されているか、接続されていました。