Aprender
Clase de motor
AudioEmitter

*Este contenido se traduce usando la IA (Beta) y puede contener errores. Para ver esta página en inglés, haz clic en aquí.


Muestras de código
Reproduciendo un activo desde múltiples ubicaciones 3D a la vez
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()

Referencia API
Propiedades
AcousticSimulationEnabled
Leer paralelo
Capacidades: Audio
AudioEmitter.AcousticSimulationEnabled:boolean

AngleAttenuation
Seguridad de Roblox
Leer paralelo
Capacidades: Audio
AudioEmitter.AngleAttenuation:Flyweight

AudioInteractionGroup
Leer paralelo
Capacidades: Audio
AudioEmitter.AudioInteractionGroup:string

DistanceAttenuation
Seguridad de Roblox
Leer paralelo
Capacidades: Audio
AudioEmitter.DistanceAttenuation:Flyweight

PositionInstance
Leer paralelo
Capacidades: Audio
AudioEmitter.PositionInstance:Instance

PositionType
Leer paralelo
Capacidades: Audio
AudioEmitter.PositionType:Enum.EmitterPositionType

SimulationFidelity
Obsoleto

Métodos
GetAngleAttenuation
Capacidades: Audio
AudioEmitter:GetAngleAttenuation():Dictionary
Devuelve

GetAudibilityFor
Capacidades: Audio
AudioEmitter:GetAudibilityFor(listener:AudioListener):number
Parámetros
listener:AudioListener
Devuelve

GetConnectedWires
Capacidades: Audio
AudioEmitter:GetConnectedWires(pin:string):{Wire}
Parámetros
pin:string
Devuelve

GetDistanceAttenuation
Capacidades: Audio
AudioEmitter:GetDistanceAttenuation():Dictionary
Devuelve

GetInputPins
Capacidades: Audio
AudioEmitter:GetInputPins():{any}
Devuelve

GetInteractingListeners
Capacidades: Audio
AudioEmitter:GetInteractingListeners():{AudioListener}
Devuelve

GetOutputPins
Capacidades: Audio
AudioEmitter:GetOutputPins():{any}
Devuelve

SetAngleAttenuation
Capacidades: Audio
AudioEmitter:SetAngleAttenuation(curve:Dictionary):()
Parámetros
Devuelve
()

SetDistanceAttenuation
Capacidades: Audio
AudioEmitter:SetDistanceAttenuation(curve:Dictionary):()
Parámetros
Devuelve
()
Muestras de código
Atenuación de Distancia Personalizada
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 -- Dentro de una distancia de 10 studs, los oyentes escuchan este emisor a volumen completo
curve[100] = 0.4 -- A una distancia de 100 studs, los oyentes escuchan este emisor al 40% del volumen
curve[300] = 0 -- A cualquier distancia mayor a 300 studs, los oyentes no pueden escuchar este emisor
emitter:SetDistanceAttenuation(curve)
-- Replica la curva de atenuación de la antigua implementación de voz
-- La voz predeterminada sin la nueva API de audio utiliza una atenuación cuadrática que varía de 7 a 80 studs
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

Eventos
WiringChanged
Capacidades: Audio
AudioEmitter.WiringChanged(
connected:boolean, pin:string, wire:Wire, instance:Instance
Parámetros
connected:boolean
pin:string
wire:Wire
instance:Instance

©2026 Roblox Corporation. Roblox, el logotipo de Roblox y "Powering Imagination" son algunas de nuestras marcas registradas y no registradas en los Estados Unidos y otros países.