Informacje o wersji
Edukacja
Klasa silnika
AudioEmitter

*Ta zawartość została przetłumaczona przy użyciu narzędzi AI (w wersji beta) i może zawierać błędy. Aby wyświetlić tę stronę w języku angielskim, kliknij tutaj.


Przykłady kodu
Odtwarzanie jednego obiektu z wielu lokalizacji 3D jednocześnie
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()

Materiały referencyjne dotyczące interfejsów API
Właściwości
AcousticSimulationEnabled
Odczyt równoległy
Możliwości: Audio
AudioEmitter.AcousticSimulationEnabled:boolean

AngleAttenuation
Zabezpieczenia na platformie Roblox
Odczyt równoległy
Możliwości: Audio
AudioEmitter.AngleAttenuation:Flyweight

AudioInteractionGroup
Odczyt równoległy
Możliwości: Audio
AudioEmitter.AudioInteractionGroup:string

DistanceAttenuation
Zabezpieczenia na platformie Roblox
Odczyt równoległy
Możliwości: Audio
AudioEmitter.DistanceAttenuation:Flyweight

PositionInstance
Odczyt równoległy
Możliwości: Audio
AudioEmitter.PositionInstance:Instance

PositionType
Odczyt równoległy
Możliwości: Audio
AudioEmitter.PositionType:Enum.EmitterPositionType

SimulationFidelity
Przestarzałe

Metody
GetAngleAttenuation
Możliwości: Audio
AudioEmitter:GetAngleAttenuation():Dictionary

GetAudibilityFor
Możliwości: Audio
AudioEmitter:GetAudibilityFor(listener:AudioListener):number
Parametry
listener:AudioListener
Zwroty

GetConnectedWires
Możliwości: Audio
AudioEmitter:GetConnectedWires(pin:string):{Wire}
Parametry
pin:string
Zwroty

GetDistanceAttenuation
Możliwości: Audio
AudioEmitter:GetDistanceAttenuation():Dictionary

GetInputPins
Możliwości: Audio
AudioEmitter:GetInputPins():{any}
Zwroty

GetInteractingListeners
Możliwości: Audio
AudioEmitter:GetInteractingListeners():{AudioListener}

GetOutputPins
Możliwości: Audio
AudioEmitter:GetOutputPins():{any}
Zwroty

SetAngleAttenuation
Możliwości: Audio
AudioEmitter:SetAngleAttenuation(curve:Dictionary):()
Parametry
Zwroty
()

SetDistanceAttenuation
Możliwości: Audio
AudioEmitter:SetDistanceAttenuation(curve:Dictionary):()
Parametry
Zwroty
()
Przykłady kodu
Niestandardowe tłumienie odległości
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 -- W odległości 10 studów, słuchacze słyszą ten emiter na pełnej głośności
curve[100] = 0.4 -- W odległości 100 studów, słuchacze słyszą ten emiter na 40% głośności
curve[300] = 0 -- W wszelkich odległościach większych niż 300 studów, słuchacze nie mogą słyszeć tego emitera
emitter:SetDistanceAttenuation(curve)
-- Replikuj krzywą tłumienia ze starej implementacji głosu
-- Domyślny głos bez nowego interfejsu audio używa kwadratowego tłumienia w zakresie od 7 do 80 studów
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

Zdarzenia
WiringChanged
Możliwości: Audio
AudioEmitter.WiringChanged(
connected:boolean, pin:string, wire:Wire, instance:Instance
Parametry
connected:boolean
pin:string
wire:Wire
instance:Instance

©2026 Roblox Corporation. Nazwa Roblox, logo Roblox oraz hasło „Powering Imagination” należą do naszych zarejestrowanych i niezarejestrowanych znaków towarowych na terenie Stanów Zjednoczonych oraz w innych krajach.