Sound

Artık kullanılmayanları göster

*Bu içerik, yapay zekâ (beta) kullanılarak çevrildi ve hatalar içerebilir. Sayfayı İngilizce görüntülemek için buraya tıkla.

Bir Sound bir ses yayan bir nesnedir.

2D ve 3D Ses

Bir sesi BasePart veya bir Attachment içine yerleştirilen bir ses,

Bir ses BasePart veya Attachment ile ilgili değilse "küresel" olarak kabul edilir. Bu durumda, ses aynı hacimde tüm dünyaboyunca oynatılır.

Kod Örnekleri

Music Playing Part

local part = Instance.new("Part")
part.Anchored = true
part.Position = Vector3.new(0, 3, 0)
part.BrickColor = BrickColor.new("Bright red")
part.Name = "MusicBox"
part.Parent = workspace

-- create a sound
local sound = Instance.new("Sound", part)
sound.SoundId = "rbxassetid://9120386436" 
sound.EmitterSize = 5 -- decrease the emitter size (for earlier volume drop off)
sound.Looped = true
sound.Parent = part

local clickDetector = Instance.new("ClickDetector")
clickDetector.Parent = part

-- toggle the sound playing / not playing
clickDetector.MouseClick:Connect(function()
	if not sound.IsPlaying then
		part.BrickColor = BrickColor.new("Bright green")
		sound:Play()
	else
		part.BrickColor = BrickColor.new("Bright red")
		sound:Stop()
	end
end)

Sound in the Workspace

local sound = Instance.new("Sound")
sound.SoundId = "rbxassetid://9120386436"
sound.Looped = true
sound.Parent = workspace
sound:Play()

Özet

Özellikler

ChannelCount:number
Salt Okunur
Çoğaltılmamış
Gezilemez
Roblox Betik Güvenliği
Paralel oku
IsLoaded:bool
Salt Okunur
Çoğaltılmamış
Paralel oku
Bu özellik, Sound adlı öğenin Roblox sunucusundan yüklenmiş olması ve oynamaya hazır olması durumunda doğrudur.
IsPaused:bool
Gizli
Salt Okunur
Çoğaltılmamış
Paralel oku
Bu okuma yalnızca özellik Sound çalıştığında geri dönecektir.
IsPlaying:bool
Gizli
Salt Okunur
Çoğaltılmamış
Paralel oku
Bu sadece okuma özelliği, Sound çalınırken geri dönecektir.
LoopRegion:NumberRange
Paralel oku
Class.Sound.PlaybackRegion içindeki istediğiniz bir dizi başlangıcı ve dizi sonunu gösteren bir menzil.
Looped:bool
Paralel oku
Bu, Sound'in oynadığında bittiğinde tekrarlanıp tekrarlanmayacağını ayarlar.
PlayOnRemove:bool
Paralel oku
Doğruysa, Sound oyundan kaldırıldığında çalır, Sound ya da onun atalarından biri ile yuva edinir.
PlaybackLoudness:number
Salt Okunur
Çoğaltılmamış
Paralel oku
Class.Sound ın şu anda ne kadar yüksek ses çıkardığını gösteren bir sayı. 0 ile 1 arasında bir geri.
PlaybackRegion:NumberRange
Paralel oku
Bir Class.Sound.TimeLength içinde, saniye içinde istediğiniz başlangıcı (min) ve durdurma (max) süresini gösteren bir menzil.
PlaybackRegionsEnabled:bool
Paralel oku
Eğer doğru , bu özellik, Sound 'ınızın Sound.PlaybackRegion ve 2> Class.Sound.LoopRegion2> özelliklerine erişimini sağlar, bu da onun oynatma tarzını daha doğru kontrol edebilir.
PlaybackSpeed:number
Çoğaltılmamış
Paralel oku
Bir Sound ın oynayacağı hızı belirler, daha yüksek değerler yüzünden sesin daha hızlı ve daha yüksek bir tonla oynatılmasını sağlar.
Playing:bool
Çoğaltılmamış
Paralel oku
Şu anda Sound oynadığını gösterir.
RollOffMaxDistance:number
Paralel oku
Maksimum mesafe, özelliklerinin içindeki <a href="/reference/engine/datatypes">özellikler</a> içinden ve hala duyulabilir. Sadece <c>Class.Part</c> veya <c>Class.Configuration</c> ile ilgili sesler için geçerlidir (3D sesler).
RollOffMinDistance:number
Paralel oku
3D bir Sound (doğrudan bir BasePart veya Attachment çocuğu) başlayacak azalmaya başlayacak (hacimde azalma).
RollOffMode:Enum.RollOffMode
Paralel oku
Bir 3D Sound (ebeveyni bir BasePart ile veya bir Attachment ile değiştirilmiş olup) kontrol etmez, sesin ebeveyni değiştiren mesafenin arttığına göre davranır.
SoundGroup:SoundGroup
Paralel oku
Bu ses grubuna bağlanan SoundGroup . Ses efektleri, ses grubuna uygulanan Volume ve SoundEffects'ler sese geçer. Bir ses grubu sadece bir ses grubunda olabilir.
SoundId:ContentId
Paralel oku
Bu özellik, Sound nesnelerinin içeriğiyle ilgili bir ses dosyasının içeriğidir. Bir ses yüklenmiş olduğunda, içeriği Roblox'a yüklenmiş sesin URL'sinde bulunabilir.
TimeLength:number
Salt Okunur
Çoğaltılmamış
Paralel oku
Class.Sound 'in saniye içindeki uzunluğu. Sound yüklenmediyse bu değer 0 olur.
TimePosition:number
Çoğaltılmamış
Paralel oku
Class.Sound . İçerik içinde önbelleğe alınır ve oynatılır. Oynatma sırasında içerik önbelleğinden kaldırılır ve oynatılmaz.
Volume:number
Paralel oku
Class.Sound . Sesin oranını ayarlayabilirsiniz. Standart, 0.5'tir.

Şuradan alınanların tümünü görüntüle: Instance

Şuradan alınanların tümünü görüntüle: Object

Yöntemler

Pause():void
Class.Sound.Playing ı false olarak ayarlar. Bu, sesin çalıyor olduğu durumda Sound ın oynatılmasını durdurur. Sound.TimePosition , 1> Class.Sound1> ın yeniden başlatılmasından sonra devam edecektir.
Play():void
Oynar Sound . Set Sound.TimePosition ile son değeri ayarlar ve ardından Script (ya da 0 değilse) ile 1> Class.Sound.Playing1> ını ayarlar.
Resume():void
Resumes the Sound . Sets Sound.Playing to true. Does not alter Sound.TimePosition and thus can be used to resume the playback of a sound stopped using 1> Class.Sound:Pause()1> .
Stop():void
Class.Sound durdurur. Sound.Playing değerini false olarak ayarlar ve Sound.TimePosition değerini 0 olarak ayarlar.

Şuradan alınanların tümünü görüntüle: Instance

Şuradan alınanların tümünü görüntüle: Object

Etkinlikler

DidLoop(soundId : string,numOfTimesLooped : number):RBXScriptSignal
Class.Sound 루프ları herhangi bir zaman ateşleyen olay. Return soundId ve numOfTimesLooped, içerik ID'sini ve sesin iki katı olarak çevirim sayısını verir.
Ended(soundId : string):RBXScriptSignal
Oynatma işlemi tamamlandığında Sound ın oynatma işlevini durdurur.
Loaded(soundId : string):RBXScriptSignal
Class.Sound yüklendiğinde yanar.
Paused(soundId : string):RBXScriptSignal
Class.Sound:Pause kullanılarak Sound:Pause() 'i durdurduğunda herhangi bir anda yanar.
Played(soundId : string):RBXScriptSignal
Class.Sound:Play() işlevi kullanılarak Sound:Play() işlevi çalındığında herhangi bir zaman ateş eder.
Resumed(soundId : string):RBXScriptSignal
Class.Sound:Resume() kullanılarak Sound:Resume() ile devam edildiğinde yanar.
Stopped(soundId : string):RBXScriptSignal
Class.Sound:Stop işlevi nedeniyle Sound:Stop() işlevi durdurulduğunda yanar.

Şuradan alınanların tümünü görüntüle: Instance

Şuradan alınanların tümünü görüntüle: Object

Özellikler

ChannelCount

number

Salt Okunur

Çoğaltılmamış

Gezilemez

Roblox Betik Güvenliği

Paralel oku

IsLoaded

bool

Salt Okunur

Çoğaltılmamış

Paralel oku

Bu özellik, Sound adlı öğenin Roblox sunucusundan yüklenmiş olması ve oynamaya hazır olması durumunda doğrudur.

Roblox'ta, ses dosyaları oyunların kendilerine değil Roblox sunucularına saklanır ve Sound.SoundId özelliği tarafından işaret edilir. Bu, seslerin oynatılabilir olması için kliğinizin bir cihazına indirilmesi gerektiğini ifade eder. Bu, kullanıcının internet bağlantıs

Geliştiriciler, bir sesi oynatmadan önce bir sesin yüklendiğinden emin olmak için Sound.IsLoaded ve Sound.Loaded etkinliğini kullanabilir.

Kod Örnekleri

Load Sound

local sound = script.Parent.Sound

if not sound.IsLoaded then
	sound.Loaded:Wait()
end

print("The sound has loaded!")

IsPaused

bool

Gizli

Salt Okunur

Çoğaltılmamış

Paralel oku

Bu yalnızca okuma için özellik olarak geri dönecektir, Sound öğesi durduğunda. Not et ki, bu öğütün sadece bir ses askıya alındığında durduğunda geri dönecektir, ama asla Sound:Pause() işlevini kullanarak askıya alınmış olmayan bir sesi durdurmayacaktır.

Bu özellik yalnızca Sound.IsPlaying doğru olduğunda gerçekleşir.

As IsPaused okunurken, sesi durdurmak için kullanılamaz, Sound:Stop() ve Sound:Pause() yerine kullanılmalıdır.

Kod Örnekleri

Sound IsPlaying and SoundIsPaused

local sound = Instance.new("Sound")
sound.SoundId = "rbxassetid://9120386436"
sound.Looped = true
sound.Parent = workspace

if not sound.isLoaded then
	sound.Loaded:Wait()
end

sound:Play()
print(sound.IsPlaying, sound.IsPaused) -- true, false

task.wait(2)
sound:Pause()
print(sound.IsPlaying, sound.IsPaused) -- false, true

task.wait(2)
sound:Play()
print(sound.IsPlaying, sound.IsPaused) -- true, false

task.wait(2)
sound:Stop()
print(sound.IsPlaying, sound.IsPaused) -- false, true

IsPlaying

bool

Gizli

Salt Okunur

Çoğaltılmamış

Paralel oku

Bu sadece okuma özelliği, Sound çalınırken geri dönecektir.

Bu özellik yalnızca Sound.IsPaused değerinde gerçekleştirilebilir.

As IsPlaying okuma yalnızca sesi çalmak için kullanılamaz, Sound:Play() bunun yerine kullanılmalıdır.

Kod Örnekleri

Sound IsPlaying and SoundIsPaused

local sound = Instance.new("Sound")
sound.SoundId = "rbxassetid://9120386436"
sound.Looped = true
sound.Parent = workspace

if not sound.isLoaded then
	sound.Loaded:Wait()
end

sound:Play()
print(sound.IsPlaying, sound.IsPaused) -- true, false

task.wait(2)
sound:Pause()
print(sound.IsPlaying, sound.IsPaused) -- false, true

task.wait(2)
sound:Play()
print(sound.IsPlaying, sound.IsPaused) -- true, false

task.wait(2)
sound:Stop()
print(sound.IsPlaying, sound.IsPaused) -- false, true

LoopRegion

NumberRange

Paralel oku

Bir sesin Sound.PlaybackRegion içindeki istediğiniz bir döngü başlangıcı ve döngü sonu içindeki bir döngü için kullanılabilir bir menzil.

LoopRegion.Min > PlaybackRegion.Min > LoopRegion.Min ile başlar.
LoopRegion.MinPlaybackRegion.Min ile başlayan bir döngü, PlaybackRegion.Min ile başlar.
LoopRegion.Max > PlaybackRegion.Max > PlaybackRegion.Max > 1> Loop başlar şu anda ki 4> Class.Sound.PlaybackRegion|PlaybackRegion.Max4> .
LoopRegion.MaxPlaybackRegion.Max ile, döngü aynen o anda başlar.
Eğer LoopRegion.Min``LoopRegion.Max ile eşdeğerse, Sound bunun yerine 1> Class.Sound.PlaybackRegion1> özelliğini kullanır.

Looped

bool

Paralel oku

Bu, Sound'in oynadığında bittiğinde tekrarlanıp tekrarlanmayacağını ayarlar.

Tekrarlanan sesler müzik ve arka plan çevre sesleri dahil olmak üzere bir dizi uygulama için uygundur. Sound.DidLoop etkinliği, sesin kaç kere tekrarlandığını izlemek için kullanılabilir.

Kod Örnekleri

Sound Looping

local Players = game:GetService("Players")

local function onPlayerAdded(player)
	local function onCharacterAdded(character)
		-- wait for the head to be added
		local head = character:WaitForChild("Head")

		local sound = Instance.new("Sound")
		sound.Name = "TestSound"
		sound.SoundId = "rbxasset://sounds/uuhhh.mp3" -- oof
		sound.Parent = head

		sound.Looped = true

		sound.DidLoop:Connect(function(_soundId, numOfTimesLooped)
			print("oof! " .. tostring(numOfTimesLooped))
		end)

		sound:Play()
	end

	player.CharacterAdded:Connect(onCharacterAdded)
end

Players.PlayerAdded:Connect(onPlayerAdded)

Loop a Number of Times

local function loopNTimes(sound, numberOfLoops)
	if not sound.IsPlaying then
		sound.Looped = true
		local connection = nil
		connection = sound.DidLoop:Connect(function(_soundId, numOfTimesLooped)
			print(numOfTimesLooped)
			if numOfTimesLooped >= numberOfLoops then
				-- disconnect the connection
				connection:Disconnect()
				-- stop the sound
				sound:Stop()
			end
		end)
		sound:Play()
	end
end

local sound = Instance.new("Sound")
sound.SoundId = "rbxassetid://0"

loopNTimes(sound, 5)

PlayOnRemove

bool

Paralel oku

Doğruysa, Sound oyundan kaldığında çalacaktır.

Not, sesin çalacağını gösterir Instance.Parent ın veya atalarından biri nul olarak ayarlandığında Sound özelliğinin veya bir atalarının nul olarak ayarlandığında tüm bunların etkisiyle sesin çalacağını gösterir. Bu, PlayOnRemove'ın doğru olduğ

soundsanat:Destron sanatını yok et.Parent = nil sonsanat.Parent = nil

Kod Örnekleri

Sound PlayOnRemove

local sound = Instance.new("Sound")
sound.Name = "TestSound"
sound.SoundId = "rbxasset://sounds/uuhhh.mp3" -- oof
sound.Parent = workspace

sound.PlayOnRemove = true

task.wait(3)

sound:Destroy()

PlaybackLoudness

number

Salt Okunur

Çoğaltılmamış

Paralel oku

Class.Sound ın şu anda ne kadar yüksek ses çıkardığını gösteren bir sayı. 0 ile 1 arasında bir geri.

Bu özellik, sesin oynatımının bir an içinde oynatımını yansıtır. Bu nedenle, çoğu ses için bu sürekli olarak değişir. Bu nedenle, Roblox Studio özellikleri penceresinde 0 olarak görünebilir, ancak Scripts komut satırında okunan kod olarak geri dönecektir.

Kod Örnekleri

Volume Amplitude Bar

-- to be placed in StarterPlayer > StarterPlayerScripts

local Players = game:GetService("Players")

-- wait for local player PlayerGui
local LocalPlayer = Players.LocalPlayer
local playerGui = LocalPlayer:WaitForChild("PlayerGui")

-- create a ScreenGui
local screenGui = Instance.new("ScreenGui")
screenGui.Parent = playerGui

-- create a holder for our bar
local frame = Instance.new("Frame")
frame.AnchorPoint = Vector2.new(0.5, 0.5)
frame.Position = UDim2.new(0.5, 0, 0.5, 0)
frame.Size = UDim2.new(0.3, 0, 0.05, 0)
frame.Parent = screenGui

-- create a bar
local bar = Instance.new("Frame")
bar.Position = UDim2.new(0, 0, 0, 0)
bar.Size = UDim2.new(1, 0, 1, 0)
bar.BackgroundColor3 = Color3.new(0, 1, 0)
bar.Parent = frame

-- create a sound
local sound = Instance.new("Sound")
sound.SoundId = "rbxassetid://9120386436"
sound.Looped = true
sound.Parent = screenGui
sound:Play()

-- define a max loudness
local maxLoudness = 30

-- animate the amplitude bar
while true do
	local amplitude = math.clamp(sound.PlaybackLoudness / maxLoudness, 0, 1)
	bar.Size = UDim2.new(amplitude, 0, 1, 0)
	wait(0.05)
end

PlaybackRegion

NumberRange

Paralel oku

Bir Class.Sound.TimeLength içinde, saniye içinde istediğiniz başlangıcı (min) ve durdurma (max) süresini gösteren bir menzil.

PlaybackRegion.Min > 0 ise, ses PlaybackRegion.Min saatinde çalmaya başlar.
PlaybackRegion.Min < 0 ise, ses 0'dan başlar.
PlaybackRegion.Max > Sound.TimeLength ile, ses Sound.TimeLength ile durur.
PlaybackRegion.Max < Sound.TimeLength sağlarsa, ses o anda durur.
PlaybackRegion.Min == PlaybackRegion.Max ise, PlayBackRegion aktif değil.

PlaybackRegionsEnabled

bool

Paralel oku

Eğer doğru , bu özellik, Sound 'ınızın Sound.PlaybackRegion ve 2> Class.Sound.LoopRegion2> özelliklerine erişimini sağlar, bu da onun oynatma tarzını daha doğru kontrol edebilir.

PlaybackSpeed

number

Çoğaltılmamış

Paralel oku

Bir Sound 'in oynayacağı hızı belirler. Değer daha yüksek olduğunda, ses daha hızlı geri çalır.

Örneğin, bir 2 değeri, Sound 'ın 2 kat daha hızlı çalmasına neden olurken, bir 0.5 değeri, Class.Sound.TimeLength (saniye olarak) için ses alır. PlaybackSpeed 1 olduğunda, ses Sound.TimeLength (saniye olarak) için tamamlanır.

Bir sesin PlaybackSpeed'ini artırmak, daha yüksek bir tonla oynatmasına neden olur.

Kod Örnekleri

Sound PlaybackSpeed

local sound = Instance.new("Sound")
sound.SoundId = "rbxassetid://9120386436"
sound.Looped = true
sound.Parent = workspace

sound:Play()
task.wait(10)
sound.PlaybackSpeed = 3 -- 3x faster
task.wait(5)
sound.PlaybackSpeed = 0.5 -- 2x slower
task.wait(5)
sound.PlaybackSpeed = 1 -- default

Playing

bool

Çoğaltılmamış

Paralel oku

Class.Sound ın şu anda çalıyor olup olmadığını gösterir. Bu özellik aktifleştirilebilir ve bu özellik her zaman kopyalanır.

Stüdyo editöründe, Sounds oynatılamaz, çünkü zaman durdu. Sound.Playing'i Sounds olarak ayarlayarak sesi oynatabilirsiniz. Ancak, 1> Class.Sound|Sounds1>'i bir 4> Class.PluginGui4>

Bu özellik Sound.IsPlaying ile karıştırılmamalıdır. Okuyabilir bir özellik olduğu için oynatma başlatmak veya durdurmak için gerçekten açık veya kapalı olabilir.

Play'in false olarak ayarlandığında, sesin Sound.TimePosition özelliği yeniden ayarlanmaz. Bu, Play'in tekrar Sound:Play() sesin zaman pozisyonu devam eder. Ancak, Class.Sound:Play() işlevi kullanılırsa sesin zaman pozisyonu 0 olacaktır.

Kod Örnekleri

Sound Playing

local sound = Instance.new("Sound")
sound.SoundId = "rbxassetid://9120386436"
sound.Looped = true
sound.Parent = workspace

print("playing sound")
sound.Playing = true

task.wait(10)

print("stopping sound")
sound.Playing = false

task.wait(5)

sound.Playing = true
local timePosition = sound.TimePosition
print("resumed at time position: " .. tostring(timePosition)) -- c. 10 seconds

RollOffMaxDistance

number

Paralel oku

Maksimum mesafe, inç olarak, bir klienin dinleyicisi Sound kaynağından olabilir ve hala duyabilir. Sadece şu anda bir Part ile ilgili sesleri veya Attachment (3D sesleri) duyulur.

RollOffMaxDistance'in bir sesin attenuation'ını (geçişi) etkileme şekli (düşüşü) Sound.RollOffMode özelliğine bağlıdır. RollOffMode, ters bir tip mesafe modeli (geçiş veya InverseTapered) ayarlan

RollOffMode, Linear veya LinearSquared gibi bir lineer tipi mesafeye ayarlandığında ses Sound.EmitterSize ve MaxDistance arasında azalacaktır (yeniden oynatma hacmi, MaxDistance'te yuvarlama için sıfıra ulaşana kadar yeniden oynatma hacını azaltır). Bu daha az gerçekçi, ancak bazı durumlarda daha iyi bir şekilde y

RollOffMinDistance

number

Paralel oku

3D bir Sound (doğrudan bir BasePart veya Attachment çocuğu) başlayacak azalmaya başlayacak (hacimde azalma).

Sesler, BasePart veya Attachment olarak adlandırılan çocuklarının 3D sesleri oynarken, sesin oynatma bağımlılığı Class.Workspace

Class.Sound ın mesafesi, dinleyiciden sesin arasındaki mesafeyi aştıktan sonra şekillenir (gitmiş olur).Class.Sound ın mesafesi, dinleyiciden sesin arasındaki mesafeyi aştıktan sonra şekillenir (gitmiş olur).

RollOffMode

Enum.RollOffMode

Paralel oku

Bu özellik, 3D Sounds ın mesafeyi azaltmak için (gittikçe solgun) nasıl şekilleneceğini ayarlar (uyan). Onu Enum.RollOffMode 열inebilir.

Aşağıdaki kod RollOffMode'u Linear olarak ayarlayacaktır:


sound.RollOffMode = Enum.RollOffMode.Linear

Farklı modlar

Aşağıdaki seçenekler mevcut:


<tbody>
  <tr>
    <td>Geri</td>
    <td>Ses/RolYuvarlamaMinDistance'den <code>Ses/RollOffMinDistance</code> şeklinde bir şekilde hacim azaltır.</td>
  </tr>

  <tr>
    <td>Geriye Düzeltilmiş</td>
    <td>Bir hibrid model. Yaklaşık <code>RollOffMinDistance</code> ve <code>Sound/RollOffMaxDistance</code> yakınlığında Inverse modeline uyar.</td>
  </tr>

  <tr>
    <td>Dizgi</td>
    <td>Ses <code>Sürükleme mesafesi</code> ve <code>Ses/Sürükleme mesafesi</code> arasındaki hacim, lineer bir ilişkiyle azalır.</td>
  </tr>

  <tr>
    <td>Dikdörtgen</td>
    <td>Ses <code>Sürükleme mesafesi</code> ve <code>Ses/Sürükleme mesafesi</code> arasındaki hacim, lineer bir kare ilişkisiyle azalır.</td>
  </tr>
</tbody>

Mod	Açıklama

Geriye Dayanan vs Lineer Mesafen Azaltma

Varsayılan olarak, seslerin gerçek dünyada nasıl seslenenleri azaltacağını gösteren yanlış mesafe azaltma eğilimi (Enum.RollOffMode.Inverse) ayarlanmıştır. Yersiz mesafe azaltma eğilimi, seslerin ortak ebeveyni

RollOffMaxDistance, ters modeldeki azaltmayı etkilemez, ancak bu mesafeye ulaşıldığında sesi tamamen keser. Bu, uzun mesafe için düşük değerleri kullanırken özellikle belirgindir.

Doğrudan mesafe özelliği, sesin MaxDistance değerine bağlı olarak RollOffMinDistance ve RollOffMaxDistance arasındaki mesafeyi azaltır. Bu özellik, MaxDistance değerine bağlı olarak sesin attenuating'ini azaltır ve MaxDistance değerine ulaşıldığında sess

SoundGroup

Paralel oku

Bu SoundGroup ile bağlantılı Sound . SoundGroup.Volume ve 2>Class.SoundEffect|SoundEffects2> bu ses grubuna uygulanır. Bir ses grubunun sadece bir ses grubunda olabilir.

SoundGroups kullanılarak, birden fazla Sounds 'in ses ve etkilerini yönetmek için kullanılır. Bir Sound , ses grubunun özelliğini ayarlayarak bir 0> Class.SoundGroup0> 'e eklenir.

Kod Örnekleri

SoundGroups

local SoundService = game:GetService("SoundService")

-- create a sound group
local soundGroup = Instance.new("SoundGroup")
soundGroup.Parent = SoundService

-- create a sound
local sound = Instance.new("Sound")
sound.SoundId = "rbxassetid://9120386436"
sound.Looped = true
sound.PlaybackSpeed = 2
sound.SoundGroup = soundGroup
sound.Parent = workspace

-- play the sound
sound:Play()

task.wait(10)

-- change the volume
soundGroup.Volume = 0.1

task.wait(3)

-- return the volume
soundGroup.Volume = 0.5

task.wait(4)

-- add a sound effect
local reverb = Instance.new("ReverbSoundEffect")
reverb.Parent = soundGroup

SoundId

ContentId

Paralel oku

Bu özellik, Sound nesnelerinin içeriğiyle ilgili bir ses dosyasının içeriğidir. Bir ses yüklenmiş olduğunda, içeriği Roblox'a yüklenmiş sesin URL'sinde bulunabilir.

URL'nin içerik ID'si ile aynı olmadığını hatırlamak önemlidir. Roblox Studio'daki bir Sound ile doğrudan yapıştırıldığında çalışacak, Studio da otomatik olarak düzeltir, ancak bir Script'den alınan numarayı kullanılmalıdır, bu da


"https://www.roblox.com/catalog/9120386436" -- Web URL (çalışmaz)
"http://www.roblox.com/asset/?id=9120386436" -- İçerik Kimliği (çalışacak)
"rbxassetid://9120386436" -- Content ID (alternative version, will work)

Kod Örnekleri

Sound in the Workspace

local sound = Instance.new("Sound")
sound.SoundId = "rbxassetid://9120386436"
sound.Looped = true
sound.Parent = workspace
sound:Play()

TimeLength

number

Salt Okunur

Çoğaltılmamış

Paralel oku

Class.Sound 'in saniye içindeki uzunluğu. Sound yüklenmediyse bu değer 0 olur.

Bu özellik genellikle şu ile birleştirilir: Sound.PlaybackSpeed para birimi bir süre için kalıcı olarak kalması için sesin hızını ayarlar (örnekler). Sound.PlaybackSpeed 1 ile eşit olduğunda, sesin kalıcı olarak tamamlanması için TimeLength saniye alır.

Kod Örnekleri

Play a Sound for a Specific Duration

local function playForDuration(sound, duration)
	if not sound.IsLoaded then
		sound.Loaded:wait()
	end
	local speed = sound.TimeLength / duration
	sound.PlaybackSpeed = speed
	sound:Play()
end

local sound = script.Parent
playForDuration(sound, 5)

TimePosition

number

Çoğaltılmamış

Paralel oku

Class.Sound . Oyunun ses yönlendirme pozisyonunu gösterir. Oyun sesi çalıyorsa, ses yönlendirme kaydırıcı olarak belirlenen pozisyona otomatik olarak hareket eder. Sound . Oyun sesi çalmıyorsa, ses yönlendirici pozisyonu belirlenen pozisyonda otomatik olarak hareket eder.

Bir Sound çalındığında, TimePosition bir saniyede Sound.PlaybackSpeed artar. Bir TimePosition TimePosition ulaştığında, ses kaydedilmiş olmayan durumda Sound.TimeLength değerine ay

TimePosition değerini bir özellik olarak yuvarlak içindeki uzunluğa göre ayarlayarak etrafta sarılmayı etkilemez. Bu davranış istendiğinde geliştirici takip edilenyapmalıdır.

yeniPosition = yeniPosition - sound.TimeLength son ses.TimePosition = yeniPosition

TimePosition'ı zerondan daha az bir değere ayarlamak şu anda oynatma üzerinde etkisi yoktur, ancak bu davranış güvenilmez olmalıdır.

Kod Örnekleri

Sound TimePosition

local sound = Instance.new("Sound")
sound.SoundId = "rbxassetid://9120386436"
sound.Parent = workspace

sound.TimePosition = 30

sound:Play()

task.wait(5)

sound.TimePosition = 100

task.wait(5)

sound.TimePosition = 0

Volume

number

Paralel oku

Class.Sound . Sesin oranını ayarlayabilirsiniz. Standart, 0.5'e ayarlanır

Not et that if the Sound is a member of a SoundGroup its playback volume (but not the Volume property) will be influenced by the SoundGroup.Volume property of that 1> Class.SoundGroup1> . The effect of

Kod Örnekleri

Sound Volume

local sound = Instance.new("Sound")
sound.SoundId = "rbxassetid://9120386436"
sound.Looped = true
sound.PlaybackSpeed = 2
sound.Parent = workspace

sound.Volume = 2

sound:Play()

task.wait(7)

sound.Volume = 0.2

Şuradan alınanların tümünü görüntüle: Instance

Şuradan alınanların tümünü görüntüle: Object

Yöntemler

Pause

void

Class.Sound.Playing iletişimini Sound iletişimine ayarlar. Bu, sesin çalıyor olduğu durumda Sound:Stop() iletişimine yeniden başlatılır. 1> Class.Sound.TimePosition1> iletişimini, sesin tekrar başlatılması

Farklı ses işlevlerinin etkisi Sound.Playing ve Sound.TimePosition aşağıdaki gösterilmiştir.


<tbody>
  <tr>
    <td>Ses:Oynat()</td>
    <td>Açık</td>
    <td>Lua'da belirlenen son değer (Varsayılan 0)</td>
  </tr>

  <tr>
    <td>Ses:bekle()</td>
    <td>Kapalı</td>
    <td>-</td>
  </tr>

  <tr>
    <td>Ses: Devam Et()</td>
    <td>Açık</td>
    <td>-</td>
  </tr>

  <tr>
    <td>Ses: Durdur()</td>
    <td>Kapalı</td>
    <td>0</td>
  </tr>
</tbody>

Fonksiyon	Ses.Oynama	Ses.TimePosition

Dönüşler

void

Kod Örnekleri

Sound Functions

-- create a sound
local sound = Instance.new("Sound", game.Workspace)
sound.SoundId = "rbxassetid://9120386436"

if not sound.IsLoaded then
	sound.Loaded:Wait()
end

-- listen for events
sound.Played:Connect(function(_soundId)
	print("Sound.Played event")
end)

sound.Paused:Connect(function(_soundId)
	print("Sound.Paused event")
end)

sound.Resumed:Connect(function(_soundId)
	print("Sound.Resumed event")
end)

sound.Stopped:Connect(function(_soundId)
	print("Sound.Stopped event")
end)

sound:Play()
print("play", sound.Playing, sound.TimePosition) -- play true 0

task.wait(10)

sound:Pause()
print("pause", sound.Playing, sound.TimePosition) -- pause false 10

task.wait(3)

sound:Resume()
print("play", sound.Playing, sound.TimePosition) -- play true 10

task.wait(3)

sound:Stop()
print("stop", sound.Playing, sound.TimePosition) -- stop false 0

task.wait(3)

sound:Play()
print("play", sound.Playing, sound.TimePosition) -- play true 0

Play

void

Oynar Sound . Set Sound.TimePosition ile son değeri ayarlar ve ardından Script (ya da 0 değilse) ile 1> Class.Sound.Playing1> ını ayarlar.

Farklı Sound işlevlerinin Sound.Playing ve Sound.TimePosition üzerindeki etkisi aşağıdaki grafikte gösterilmiştir.


<tbody>
  <tr>
    <td>Ses:Oynat()</td>
    <td>Açık</td>
    <td>Lua'da belirlenen son değer (Varsayılan 0)</td>
  </tr>

  <tr>
    <td>Ses:bekle()</td>
    <td>Kapalı</td>
    <td>-</td>
  </tr>

  <tr>
    <td>Ses: Devam Et()</td>
    <td>Açık</td>
    <td>-</td>
  </tr>

  <tr>
    <td>Ses: Durdur()</td>
    <td>Kapalı</td>
    <td>0</td>
  </tr>
</tbody>

Fonksiyon	Ses.Oynama	Ses.TimePosition

Dönüşler

void

Kod Örnekleri

Sound Functions

-- create a sound
local sound = Instance.new("Sound", game.Workspace)
sound.SoundId = "rbxassetid://9120386436"

if not sound.IsLoaded then
	sound.Loaded:Wait()
end

-- listen for events
sound.Played:Connect(function(_soundId)
	print("Sound.Played event")
end)

sound.Paused:Connect(function(_soundId)
	print("Sound.Paused event")
end)

sound.Resumed:Connect(function(_soundId)
	print("Sound.Resumed event")
end)

sound.Stopped:Connect(function(_soundId)
	print("Sound.Stopped event")
end)

sound:Play()
print("play", sound.Playing, sound.TimePosition) -- play true 0

task.wait(10)

sound:Pause()
print("pause", sound.Playing, sound.TimePosition) -- pause false 10

task.wait(3)

sound:Resume()
print("play", sound.Playing, sound.TimePosition) -- play true 10

task.wait(3)

sound:Stop()
print("stop", sound.Playing, sound.TimePosition) -- stop false 0

task.wait(3)

sound:Play()
print("play", sound.Playing, sound.TimePosition) -- play true 0

Resume

void

Resumes the Sound . Sets Sound.Playing to true. Does not alter Sound.TimePosition and thus can be used to resume the playback of a sound stopped using 1> Class.Sound:Pause()1> .

Farklı ses işlevlerinin etkisi Sound.Playing ve Sound.TimePosition aşağıdaki gösterilmiştir.


<tbody>
  <tr>
    <td>Ses:Oynat()</td>
    <td>Açık</td>
    <td>Lua'da belirlenen son değer (Varsayılan 0)</td>
  </tr>

  <tr>
    <td>Ses:bekle()</td>
    <td>Kapalı</td>
    <td>-</td>
  </tr>

  <tr>
    <td>Ses: Devam Et()</td>
    <td>Açık</td>
    <td>-</td>
  </tr>

  <tr>
    <td>Ses: Durdur()</td>
    <td>Kapalı</td>
    <td>0</td>
  </tr>
</tbody>

Fonksiyon	Ses.Oynama	Ses.TimePosition

Dönüşler

void

Kod Örnekleri

Sound Functions

-- create a sound
local sound = Instance.new("Sound", game.Workspace)
sound.SoundId = "rbxassetid://9120386436"

if not sound.IsLoaded then
	sound.Loaded:Wait()
end

-- listen for events
sound.Played:Connect(function(_soundId)
	print("Sound.Played event")
end)

sound.Paused:Connect(function(_soundId)
	print("Sound.Paused event")
end)

sound.Resumed:Connect(function(_soundId)
	print("Sound.Resumed event")
end)

sound.Stopped:Connect(function(_soundId)
	print("Sound.Stopped event")
end)

sound:Play()
print("play", sound.Playing, sound.TimePosition) -- play true 0

task.wait(10)

sound:Pause()
print("pause", sound.Playing, sound.TimePosition) -- pause false 10

task.wait(3)

sound:Resume()
print("play", sound.Playing, sound.TimePosition) -- play true 10

task.wait(3)

sound:Stop()
print("stop", sound.Playing, sound.TimePosition) -- stop false 0

task.wait(3)

sound:Play()
print("play", sound.Playing, sound.TimePosition) -- play true 0

Stop

void

Class.Sound durdurur. Sound.Playing değerini false olarak ayarlar ve Sound.TimePosition değerini 0 olarak ayarlar.

Farklı ses işlevlerinin etkisi Sound.Playing ve Sound.TimePosition aşağıdaki gösterilmiştir.


<tbody>
  <tr>
    <td>Ses:Oynat()</td>
    <td>Açık</td>
    <td>Lua'da belirlenen son değer (Varsayılan 0)</td>
  </tr>

  <tr>
    <td>Ses:bekle()</td>
    <td>Kapalı</td>
    <td>-</td>
  </tr>

  <tr>
    <td>Ses: Devam Et()</td>
    <td>Açık</td>
    <td>-</td>
  </tr>

  <tr>
    <td>Ses: Durdur()</td>
    <td>Kapalı</td>
    <td>0</td>
  </tr>
</tbody>

Fonksiyon	Ses.Oynama	Ses.TimePosition

Dönüşler

void

Kod Örnekleri

Sound Functions

-- create a sound
local sound = Instance.new("Sound", game.Workspace)
sound.SoundId = "rbxassetid://9120386436"

if not sound.IsLoaded then
	sound.Loaded:Wait()
end

-- listen for events
sound.Played:Connect(function(_soundId)
	print("Sound.Played event")
end)

sound.Paused:Connect(function(_soundId)
	print("Sound.Paused event")
end)

sound.Resumed:Connect(function(_soundId)
	print("Sound.Resumed event")
end)

sound.Stopped:Connect(function(_soundId)
	print("Sound.Stopped event")
end)

sound:Play()
print("play", sound.Playing, sound.TimePosition) -- play true 0

task.wait(10)

sound:Pause()
print("pause", sound.Playing, sound.TimePosition) -- pause false 10

task.wait(3)

sound:Resume()
print("play", sound.Playing, sound.TimePosition) -- play true 10

task.wait(3)

sound:Stop()
print("stop", sound.Playing, sound.TimePosition) -- stop false 0

task.wait(3)

sound:Play()
print("play", sound.Playing, sound.TimePosition) -- play true 0

Şuradan alınanların tümünü görüntüle: Instance

Şuradan alınanların tümünü görüntüle: Object

Etkinlikler

DidLoop

Class.Sound 루프ları herhangi bir zaman ateşleyen olay. Return soundId ve numOfTimesLooped, içerik ID'sini ve sesin iki katı olarak çevirim sayısını verir.

Class.Sound durdurulduğunda, çift sayıda çekirdek sayısı yeniden ayarlanır ve böylece bir sonraki DidLoop etkinliği 1'i için geri dönecektir.

Parametreler

soundId: string

Class.Sound.SoundId ile Sound arasındaki şerit.

numOfTimesLooped: number

Sound ın tekrarlandığı sayı.

Kod Örnekleri

Loop a Number of Times

local function loopNTimes(sound, numberOfLoops)
	if not sound.IsPlaying then
		sound.Looped = true
		local connection = nil
		connection = sound.DidLoop:Connect(function(_soundId, numOfTimesLooped)
			print(numOfTimesLooped)
			if numOfTimesLooped >= numberOfLoops then
				-- disconnect the connection
				connection:Disconnect()
				-- stop the sound
				sound:Stop()
			end
		end)
		sound:Play()
	end
end

local sound = Instance.new("Sound")
sound.SoundId = "rbxassetid://0"

loopNTimes(sound, 5)

Ended

Oynatma tamamlandığında ateşlenir ve durur. Bu olay, Sound ın oynatma işlevini devre dışı bırakması durumunda oluşmaz.

Bu etkinlik, oynatma işlemi tamamlandığında bir sesi yok etmek için sıklıkla kullanılır.


sound:Play()
sound.Ended:Wait()
sound:Destroy()

Duran Sound.SoundId 'in Sound 'ı.

Kod Örnekleri

Sound Functions

-- create a sound
local sound = Instance.new("Sound", game.Workspace)
sound.SoundId = "rbxassetid://9120386436"

if not sound.IsLoaded then
	sound.Loaded:Wait()
end

-- listen for events
sound.Played:Connect(function(_soundId)
	print("Sound.Played event")
end)

sound.Paused:Connect(function(_soundId)
	print("Sound.Paused event")
end)

sound.Resumed:Connect(function(_soundId)
	print("Sound.Resumed event")
end)

sound.Stopped:Connect(function(_soundId)
	print("Sound.Stopped event")
end)

sound:Play()
print("play", sound.Playing, sound.TimePosition) -- play true 0

task.wait(10)

sound:Pause()
print("pause", sound.Playing, sound.TimePosition) -- pause false 10

task.wait(3)

sound:Resume()
print("play", sound.Playing, sound.TimePosition) -- play true 10

task.wait(3)

sound:Stop()
print("stop", sound.Playing, sound.TimePosition) -- stop false 0

task.wait(3)

sound:Play()
print("play", sound.Playing, sound.TimePosition) -- play true 0

Şuradan alınanların tümünü görüntüle: Instance

Şuradan alınanların tümünü görüntüle: Object