エンジンクラス
AudioEmitter
*このコンテンツは、ベータ版のAI（人工知能）を使用して翻訳されており、エラーが含まれている可能性があります。このページを英語で表示するには、 こちら をクリックしてください。
概要
プロパティ
AngleAttenuation:Flyweight |
DistanceAttenuation:Flyweight |
方法
GetAudibilityFor(listener: AudioListener):number |
GetConnectedWires(pin: string):{Wire} |
SetAngleAttenuation(curve: Dictionary):() |
SetDistanceAttenuation(curve: Dictionary):() |
イベント
WiringChanged(connected: boolean,pin: string,wire: Wire,instance: Instance):RBXScriptSignal |
コードサンプル
複数の3D位置から同時に1つのアセットを再生する
local part1: BasePart = workspace.Speakers.Left
local part2: BasePart = workspace.Speakers.Right
local player: AudioPlayer = workspace.AudioPlayer
local leftEmitter = Instance.new("AudioEmitter")
local rightEmitter = Instance.new("AudioEmitter")
local toLeft = Instance.new("Wire")
local toRight = Instance.new("Wire")
leftEmitter.Parent = part1
rightEmitter.Parent = part2
toLeft.Parent = leftEmitter
toLeft.SourceInstance = player
toLeft.TargetInstance = leftEmitter
toRight.Parent = rightEmitter
toRight.SourceInstance = player
toRight.TargetInstance = rightEmitter
player:Play()APIリファレンス
プロパティ
AngleAttenuation
AudioEmitter.AngleAttenuation:Flyweight
DistanceAttenuation
AudioEmitter.DistanceAttenuation:Flyweight
SimulationFidelity
方法
GetAudibilityFor
SetDistanceAttenuation
パラメータ
戻り値
()
コードサンプル
カスタム距離減衰
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イベント