AudioEmitter

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 関連する AudioEmitter .

このプロパティは内部であり、スクリプトでアクセスできません;レプリケーションをサポートするために存在します。使用詳細は、SetAngleAttenuation() を参照してください。

と が相互作用グループを共有する場合、リスナーは送信者を聞くことができます。

彼らの間の距離に基づいて、 がどれほど大声で聞こえるかに影響を与えるボリューム-オーバー-ディスタンス曲線を表示します。

このプロパティは内部であり、スクリプトでアクセスできません;レプリケーションをサポートするために存在します。使用詳細は、SetDistanceAttenuation() を参照してください。

この AudioEmitter 、MeshPart.CollisionFidelity または MeshPart.RenderFidelity と同様に、オーディオシミュレーションの詳細度を制御します。

AudioEmitters と AudioListeners は、必要な詳細レベルに同意しないオプションを使用します。

テーブルマッピング角をボリュームに返します。キーは 0 と 180 （含む）の間の数字であり、値は 0 と 1 （含む）の間の数字で、ボリュームが方向に応じて衰減する方法を説明します。このメソッドは、デフォルトの角消去曲線が使用されている場合、空のテーブルを返します。

戻り値

特定の AudioListener に対して、このエミッターがどれほど聞こえるかを計算します。結果のボリューム、0 から 1 までの範囲は、エミッターとリスナーの両方で距離と角度の衰減をカバーします。

パラメータ

戻り値

指定されたピンに接続された Wires のアレイを返します。AudioEmitter には「入力」ピンが 1 つあります。

パラメータ

戻り値

テーブルマッピング距離をボリュームに返す。キーは 0 より大きいまたは等しい数字であり、値は 0 から 1（含む）の間の数字で、ボリュームが距離を通じて衰減する方法を説明します。このメソッドは、デフォルトの距離衰減曲線が使用されている場合、空のテーブルを返します。

戻り値

戻り値

エミッターと共有する を持つアレイを返します。

戻り値

戻り値

[角度] と [角度] の間の角度に基づいて、AudioListener が AudioEmitter をどれほど大声で聞くかに影響を与える音量-角度曲線を設定します。これは、LookVector と関連付けられた AudioEmitter に基づいています。

カーブは、テーブルマッピング角キーをボリューム値にマッピングして表現されます。キーは 0 と 180 （含む）の間のユニークな数字であることが期待され、値は 0 と 1 （含む）の間の数字であることが期待されます。最大 400のキーバリューペアを含むテーブルがサポートされます。

からの角度の曲線のポイントのボリュームレベルの線形インターポレーションにより、角度値が直接上下にある曲線のポイントのボリュームレベルの間で線形インターポレーションにより決定されます。下の a または上の a にポイントがない場合、他のポイントのボリュームレベルが選択されます。本質的に、カーブは直線で結ばれたポイントの連続体であり、左右の端点を超えて、それぞれのボリュームレベルでカーブが外側に広がります。

このボリュームは、すべての他の衰減曲線 (受信 AudioListener を含む) のボリュームと乗算されて、最終的な聴覚を得ることになります。

テーブルが空または である場合、 は、定期的なボリューム値の角減衰曲線を使用するようにデフォルト設定されます。

パラメータ

戻り値

彼らの間の距離に基づいて、どれほど大声で AudioListener が AudioEmitter を聞くかに影響を与えるボリューム-オーバー-距離曲線を設定します。

カーブは、テーブルマッピング距離キーをボリューム値にマップすることで表現されます。キーは 0 より大きいか等しいユニークな数字であることが期待され、値は 0 から 1（含む）の間の数字であることが期待されます。最大 400のキーバリューペアを含むテーブルがサポートされます。

距離 からの曲線のポイントのボリュームレベルの線形インターポレーションにより、ボリュームの量が決定します。距離値が直接上下にある曲線のポイントのボリュームレベルの間で線形インターポレーションを行います。下の d または上の d にポイントがない場合、他のポイントのボリュームレベルが選択されます。本質的に、カーブは直線で結ばれたポイントの連続であり、左右の端点を超えて、それぞれのボリュームレベルで無限に外側に広がります。

このボリュームは、すべての他の衰減曲線 (受信 AudioListener を含む) のボリュームと乗算されて、最終的な聴覚を得ることになります。

テーブルが空であるか、nil である場合、AudioEmitter は逆方向の法則によって決定された距離衰減曲線を使用するデフォルトになります。

パラメータ

戻り値

local Players = game:GetService("Players")

local emitterPart = Instance.new("Part")
emitterPart.Anchored = true
emitterPart.Position = Vector3.new(0, 0, 0)
emitterPart.Parent = workspace

local emitter: AudioEmitter = Instance.new("AudioEmitter")
emitter.Parent = emitterPart

local curve = {}
curve[10] = 1 -- 10スタッドの距離内で、リスナーはこのエミッターをフルボリュームで聞く
curve[100] = 0.4 -- 100スタッドの距離で、リスナーはこのエミッターを 40% のボリュームで聞く
curve[300] = 0 -- 300スタッド以上の距離では、リスナーはこのエミッターを聞くことができません
emitter:SetDistanceAttenuation(curve)

-- 古いボイス実装からロールオフカーブを再現する
-- 新しいオーディオ API なしのデフォルトの音声は、7から 80スタッドの減衰範囲を使用します
local MIN_DISTANCE = 7
local MAX_DISTANCE = 80
local CURVE_STEP_SIZE = 2

local voiceCurve = {}
for i = MIN_DISTANCE, MAX_DISTANCE, CURVE_STEP_SIZE do
	voiceCurve[i] = ((i - MIN_DISTANCE) - (MAX_DISTANCE - MIN_DISTANCE)) ^ 2 / (MAX_DISTANCE - MIN_DISTANCE) ^ 2
end
voiceCurve[MAX_DISTANCE] = 0

local function setVoiceCurve(character)
	local voiceEmitter: AudioEmitter = character:WaitForChild("AudioEmitter")
	voiceEmitter:SetDistanceAttenuation(voiceCurve)
end

for _, player in Players:GetPlayers() do
	if player.Character then
		setVoiceCurve(player.Character)
	end
	player.CharacterAdded:Connect(setVoiceCurve)
end

Wire が接続または切断された後に発生するイベント、および Wire が現在または以前に AudioEmitter および他のワイヤー可能なインスタンスのピンに接続されているか、接続されていました。

パラメータ