Impara
Classe motore
AudioEmitter

*Questo contenuto è tradotto usando AI (Beta) e potrebbe contenere errori. Per visualizzare questa pagina in inglese, clicca qui.


Campioni di codice
Giocare un asset da più posizioni 3d contemporaneamente
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()

Riferimento API
Proprietà
AcousticSimulationEnabled
Lettura Parallela
Capacità: Audio
AudioEmitter.AcousticSimulationEnabled:boolean

AngleAttenuation
Sicurezza Roblox
Lettura Parallela
Capacità: Audio
AudioEmitter.AngleAttenuation:Flyweight

AudioInteractionGroup
Lettura Parallela
Capacità: Audio
AudioEmitter.AudioInteractionGroup:string

DistanceAttenuation
Sicurezza Roblox
Lettura Parallela
Capacità: Audio
AudioEmitter.DistanceAttenuation:Flyweight

PositionInstance
Lettura Parallela
Capacità: Audio
AudioEmitter.PositionInstance:Instance

PositionType
Lettura Parallela
Capacità: Audio
AudioEmitter.PositionType:Enum.EmitterPositionType

SimulationFidelity
Obsoleto

Metodi
GetAngleAttenuation
Capacità: Audio
AudioEmitter:GetAngleAttenuation():Dictionary
Restituzioni

GetAudibilityFor
Capacità: Audio
AudioEmitter:GetAudibilityFor(listener:AudioListener):number
Parametri
listener:AudioListener
Restituzioni

GetConnectedWires
Capacità: Audio
AudioEmitter:GetConnectedWires(pin:string):{Wire}
Parametri
pin:string
Restituzioni

GetDistanceAttenuation
Capacità: Audio
AudioEmitter:GetDistanceAttenuation():Dictionary
Restituzioni

GetInputPins
Capacità: Audio
AudioEmitter:GetInputPins():{any}
Restituzioni

GetInteractingListeners
Capacità: Audio
AudioEmitter:GetInteractingListeners():{AudioListener}
Restituzioni

GetOutputPins
Capacità: Audio
AudioEmitter:GetOutputPins():{any}
Restituzioni

SetAngleAttenuation
Capacità: Audio
AudioEmitter:SetAngleAttenuation(curve:Dictionary):()
Parametri
Restituzioni
()

SetDistanceAttenuation
Capacità: Audio
AudioEmitter:SetDistanceAttenuation(curve:Dictionary):()
Parametri
Restituzioni
()
Campioni di codice
Attenuazione della distanza personalizzata
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 -- Entro una distanza di 10 stud, gli ascoltatori sentono questo emettitore a volume massimo
curve[100] = 0.4 -- A una distanza di 100 stud, gli ascoltatori sentono questo emettitore al 40% del volume
curve[300] = 0 -- A qualsiasi distanza superiore a 300 stud, gli ascoltatori non possono sentire questo emettitore
emitter:SetDistanceAttenuation(curve)
-- Replica la curva di rolloff dall'implementazione vocale precedente
-- La voce predefinita senza la nuova API audio utilizza un rolloff quadratico che va da 7 a 80 stud
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

Eventi
WiringChanged
Capacità: Audio
AudioEmitter.WiringChanged(
connected:boolean, pin:string, wire:Wire, instance:Instance
Parametri
connected:boolean
pin:string
wire:Wire
instance:Instance

© 2026 Roblox Corporation. Roblox, il logo Roblox e Powering Imagination sono tra i nostri marchi registrati e non registrati negli Stati Uniti. e altri paesi.