Informacje o wersji
Edukacja
Klasa silnika
SoundService
Brak możliwości tworzenia
Usługa

*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
Dynamiczny system pogłosu
local Players = game:GetService("Players")
local CollectionService = game:GetService("CollectionService")
local SoundService = game:GetService("SoundService")
local localPlayer = Players.LocalPlayer
local reverbTags = {
["reverb_Cave"] = Enum.ReverbType.Cave,
}
-- zbierz części i grupuj je według tagu
local parts = {}
for reverbTag, reverbType in pairs(reverbTags) do
for _, part in pairs(CollectionService:GetTagged(reverbTag)) do
parts[part] = reverbType
end
end
-- funkcja do sprawdzenia, czy pozycja znajduje się w obrębie części
local function positionInPart(part, position)
local extents = part.Size / 2
local offset = part.CFrame:PointToObjectSpace(position)
return offset.x < extents.x and offset.y < extents.y and offset.z < extents.z
end
local reverbType = SoundService.AmbientReverb
while true do
task.wait()
if not localPlayer then
return
end
local character = localPlayer.Character
-- domyślnie bez pogłosu
local newReverbType = Enum.ReverbType.NoReverb
if character and character.PrimaryPart then
local position = character.PrimaryPart.Position
-- przejrzyj wszystkie zaindeksowane części
for part, type in pairs(parts) do
-- sprawdź, czy postać znajduje się w ich obrębie
if positionInPart(part, position) then
-- jeśli tak, wybierz ten typ pogłosu
newReverbType = type
break
end
end
end
-- ustaw typ pogłosu, jeśli uległ zmianie
if newReverbType ~= reverbType then
SoundService.AmbientReverb = newReverbType
reverbType = newReverbType
end
end

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

AmbientReverb
Odczyt równoległy
Możliwości: Audio
SoundService.AmbientReverb:Enum.ReverbType

CharacterSoundsUseNewApi
Zabezpieczenia dodatku plug-in
Odczyt równoległy
Możliwości: Audio
SoundService.CharacterSoundsUseNewApi:Enum.RolloutState

DefaultListenerLocation
Zabezpieczenia dodatku plug-in
Odczyt równoległy
Możliwości: Audio
SoundService.DefaultListenerLocation:Enum.ListenerLocation

DistanceFactor
Odczyt równoległy
Możliwości: Audio
SoundService.DistanceFactor:number

DopplerScale
Odczyt równoległy
Możliwości: Audio
SoundService.DopplerScale:number

ListenerCFrame
Odczyt równoległy
Możliwości: Audio
SoundService.ListenerCFrame:CFrame

ListenerObject
Odczyt równoległy
Możliwości: Audio
SoundService.ListenerObject:Instance

ListenerType
Odczyt równoległy
Możliwości: Audio
SoundService.ListenerType:Enum.ListenerType

RespectFilteringEnabled
Odczyt równoległy
Możliwości: Audio
SoundService.RespectFilteringEnabled:boolean

RolloffScale
Odczyt równoległy
Możliwości: Audio
SoundService.RolloffScale:number

VolumetricAudio
Brak możliwości dodawania do skryptu
Odczyt równoległy
Możliwości: Audio
SoundService.VolumetricAudio:Enum.VolumetricAudio

Metody
GetListener
Możliwości: Audio
SoundService:GetListener():Tuple
Zwroty

GetMixerTime
Możliwości: Audio
SoundService:GetMixerTime():number
Zwroty

OpenAttenuationCurveEditor
Zabezpieczenia dodatku plug-in
Możliwości: Audio
SoundService:OpenAttenuationCurveEditor(selectedCurveObjects:Instances):()
Parametry
selectedCurveObjects:Instances
Zwroty
()

OpenDirectionalCurveEditor
Zabezpieczenia dodatku plug-in
Możliwości: Audio
SoundService:OpenDirectionalCurveEditor(selectedCurveObjects:Instances):()
Parametry
selectedCurveObjects:Instances
Zwroty
()

PlayLocalSound
Możliwości: Audio
SoundService:PlayLocalSound(sound:Instance):()
Parametry
sound:Instance
Zwroty
()

SetListener
Możliwości: Audio
SoundService:SetListener(
listenerType:Enum.ListenerType, listener:Tuple
):()
Parametry
listenerType:Enum.ListenerType
listener:Tuple
Zwroty
()

©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.