Girdi Eylem Sistemi

Çoklu platformlu Girdi Eylem Sistemi, eylemleri bağlayıp çeşitli donanım girdileri arasında bağlamaları düzenlemenizi sağlar. Bağlamalar ile bir araya getirildiğinde, herhangi bir cihazda herhangi bir oyun aşamasında çalışan modüler bir girdi sistemini kolayca yapılandırabilir ve düzenleyebilirsiniz. Kullanım senaryoları arasında şunlar bulunur:

• Oyuncunun savaş modunda mı yoksa seyirci modunda mı olduğuna bağlı olarak eylemlerin dinamik olarak yer değiştirdiği bir birinci şahıs nişancı sistemi.
• Hızlanma/yavaşlama, araç yükselticileri ve yakıt istasyonlarıyla donatılmış kapsamlı bir sürüş sistemi.
• Bir dövüş oyununda hamlelerin pürüzsüz bir şekilde değiştirilebileceği bir beceri sistemi için kısayollar.

Girdi bağlamları

Bir InputContext, ilişkili girdi eylemlerini barındıran bir eylem koleksiyonudur; örneğin, oyun içi karakter kontrolleri için PlayContext ve UI menüleri arasında gezinme kontrolleri için NavContext. Bağlamları (ve bunlara karşılık gelen eylemleri) Enabled özelliği aracılığıyla etkinleştirebilir/devre dışı bırakabilirsiniz; örneğin, bir envanter menüsü açıkken NavContext'i etkinleştirip oyuncu menüyü kapattığında ve birincil oyuna döndüğünde PlayContext'e geçiş yapabilirsiniz.

Bir oyun başlangıçta birden fazla girdi bağlamı kullanmıyorsa bile, herhangi bir girdi sisteminin en üst seviyesinde bir temel bağlam oluşturulması önerilir; örneğin, oyun sırasında gerçekleşen girdi için PlayContext örneği.

1. TAVSİYE

   Çeşitli girdi bağlamlarını barındıracak şekilde ReplicatedStorage içinde Inputs adında bir Folder oluşturun.

   

2. Klasöre yeni bir InputContext ekleyin ve adını PlayContext olarak değiştirin.

   

3. Özellikler penceresinde, Priority değerini 2000 olarak ayarlayın ve Sink'i etkinleştirin. Sink etkinleştirildiğinde, öncelik düzeyinde, bağlı KeyCodes için girdi olaylarını tüketir ve bu girdilerin daha düşük öncelikli bağlamlara ulaşmasını engeller. Bu, açıkken belirli oyun girdi işlemlerini bastırması gereken bir envanter ekranı gibi kullanım senaryoları için kullanılabilir. Bu örnekte, PlayContext, bağlı girdilerini varsayılan PlayerScripts bağlamları işlemden geçmeden önce engelleyecek kadar yüksek bir Priority değerine sahiptir.

Girdi eylemleri

Bir InputAction, "Sıçra", "Koş", veya "Ateş et" gibi bir oyun eylemi mekanizmasını tanımlar. Bu eylemler, girdi bağlamaları kullanılarak donanım girdilerine eşlenir.

Bir InputAction, Type özelliğine bağlı olarak birkaç varyasyona sahip olabilir (Enum.InputActionType). Varsayılan değer Bool'dur ve bu, ButtonA, E, veya MouseLeftButton gibi girdilerin basılması/serbest bırakılması ile true/false değerlerini almak için tasarlanmıştır.

Basit bir karakter sprinti için bir InputAction test etmek üzere:

1. ReplicatedStorage içindeki PlayContext bağlamı içinde yeni bir InputAction oluşturun. Adını, özelleşmiş eylemini belirtmek için CharacterSprint olarak değiştirin.

   

2. Özellikler penceresinde, eylemin Type değerinin Bool olduğunu gözlemleyin (varsayılan). Bu, basılı/serbest bırakılmış bir eylem olarak true/false eylemi için mantıksal bir türdür (karakter ya koşuyor ya da koşmuyor).

   

Girdi bağlamaları

Bir InputBinding, hangi donanım bağlamasının bağlı olan InputAction'ı tetiklemesi gerektiğini tanımlar; örneğin, bir tuşa basma, oyun kumandası düğmesi veya dokunmatik özellikli bir cihazda bir dokunuş. Çoklu platform uyumluluğu için her bir InputAction, burada gösterildiği gibi oyun kumandası, klavye/fare ve dokunmatik için bir InputBinding bulundurmalıdır.

Ana InputAction'a atanmış olan Type, çocuk InputBinding örnekleri için geçerli olan genel girdi türlerini (tuş/düğme/dokunma, analog tetikleyici, joyistik vb.) doğrudan etkiler. Aynı şekilde, ana eylemin bağlı olaylarına gönderilen değerler, bir bağlamanın seçilen girdi türüne bağlıdır. Eylem türleri, bağlamalar ve dönüş değerleri arasındaki ilişki için girdi olaylarını kontrol edin.

Basit karakter sprinti için bağlamaları bağlamak üzere:

1. CharacterSprint eylemine yeni bir InputBinding ekleyin ve adını KeyboardBinding olarak değiştirin. Sonra, bağlamanın KeyCode özelliğini LeftShift olarak ayarlayın.

   

   

2. Fare Shift kilidinin tuş bağlamasıyla çakışmaması için, Explorer'da StarterPlayer'ı seçin ve Özellikler penceresinde EnableMouseLockOption'ı devre dışı bırakın.

   

   

3. CharacterSprint eylemine ikinci bir InputBinding ekleyin ve adını GamepadBinding olarak değiştirin. Sonra, bağlamanın KeyCode özelliğini ButtonY olarak ayarlayın.

   

   

4. StarterGui içerisindeki bir ScreenGui konteynerinin içine bir ekran butonu ekleyin, adını SprintButton olarak değiştirin ve istediğiniz gibi konumlandırıp/ölçeklendirin.

   

5. CharacterSprint eylemine üçüncü bir InputBinding ekleyin ve adını TouchBinding olarak değiştirin. Sonra, Özellikler penceresinde, bağlamanın UIButton özelliğini önceki adımda oluşturduğunuz SprintButton butonuna bağlayın.

   

   

Girdi olayları

InputAction örneği, InputBindings'ten gelen oyuncu girdisini işlemek üzere üç yerleşik olay içerir.

• Pressed — Bu olay sadece girdi eyleminin Type değeri Bool olarak ayarlandığında ve durum false'dan true'ya geçiş yaptığında tetiklenir.
• Released — Bu olay sadece girdi eyleminin Type değeri Bool olarak ayarlandığında ve durum true'dan false'a geçiş yaptığında tetiklenir.
• StateChanged — Bu olay, durum değiştiğinde tüm girdi eylem türleri için tetiklenir; durum aynı duruma geçmeye çalışmadığı sürece.

Bir girdi eyleminin Type'ı (Bool, Direction1D, Direction2D, Direction3D veya ViewportPosition) ve bir çocuk InputBinding'den (tuş/düğme/dokunma, analog tetikleyici, joyistik vb.) gelen genel girdi türüne bağlı olarak, Pressed, Released ve StateChanged olay işleyicilerine farklı değerler döner. Aşağıdaki tablolar, ilişkiyi daha iyi anlamanıza yardımcı olacaktır.

Bool türü, atlama, ateş etme, koşma gibi tetiklenen eylemler için en iyi şekilde kullanılır ve analog girdilerde basılı/serbest bırakılmış eşikleri destekler.

Basit bir karakter sprinti için olayları bağlamak üzere:

1. CharacterSprint ağacına yeni bir Script ekleyin; bu, çeşitli girdi bağlamalarının yanında yer almalıdır. Sonra RunContext değerini Client olarak ayarlayın ve adını OnActivate olarak değiştirin.

   

2. Aşağıdaki kodu OnActivate betiğine yapıştırın. 13-15. satırlardaki Pressed olayı bağlantısının, sprint girdi bağlaması basıldığında karakterin yürüyüş hızını iki katına çıkardığını ve 16-18. satırlardaki ilgili Released olay bağlantısının, sprint girdi bağlaması serbest bırakıldığında yürüyüş hızını varsayılan değere sıfırladığını unutmayın.

   OnActivate (İstemci Betiği)
   local Players = game:GetService("Players")
   
   local player = Players.LocalPlayer
   local character = player.Character
   if not character or character.Parent == nil then
   	character = player.CharacterAdded:Wait()
   end
   local humanoid = character:WaitForChild("Humanoid")
   local defaultWalkSpeed = humanoid.WalkSpeed
   
   local inputAction = script.Parent
   
   inputAction.Pressed:Connect(function()
   	humanoid.WalkSpeed = defaultWalkSpeed * 2
   end)
   inputAction.Released:Connect(function()
   	humanoid.WalkSpeed = defaultWalkSpeed
   end)

3. Oyununuzu oynatın ve daha önce seçtiğiniz bağlamalar ile karakter sprint eylemini test edin: klavye için LeftShift, oyun kumandası için ButtonY ve dokunmatik özellikli cihazlar için ekran üzerindeki SprintButton. Oyun kumandası girdilerini doğrudan Roblox Studio'da test etmek için Kontrolcü Emülatörü kullanabileceğinizi unutmayın.

Bağlam değişiklikleri

Bir girdi bağlamı olan PlayContext gibi bağlamlar, oyun sırasında script aracılığıyla etkinleştirip/devre dışı bırakabilir, hangi eylemlerin başkalarına göre öncelikli olacağını belirlemek için Priority değerini değiştirebilir ve düşük önceliğe sahip bağlamlarda işlenmesini engellemek için Sink kullanabilirsiniz.

1. Diğer scriptlerden bağlamları değiştirmeyi kolaylaştırmak için, ReplicatedStorage içindeki girdi klasörünüze yeni bir BindableEvent ekleyin ve adını ContextEvent olarak değiştirin.

   

2. Aynı seviyeye yeni bir Script oluşturun, RunContext değerini Client olarak ayarlayın ve adını UpdateContext olarak değiştirin.

   

3. UpdateContext scripti içinde, aşağıdaki kodu yapıştırın:

   UpdateContext (İstemci Betiği)
   local ReplicatedStorage = game:GetService("ReplicatedStorage")
   
   local inputsFolder = ReplicatedStorage:WaitForChild("Inputs")
   local contextEvent = inputsFolder:WaitForChild("ContextEvent")
   
   -- Bağlanabilir olayı bağla
   contextEvent.Event:Connect(function(targetContext, enabled)
   	local context = inputsFolder:FindFirstChild(targetContext)
   	if context then
   		context.Enabled = enabled
   		print(context.Name .. ": " .. tostring(context.Enabled))
   	else
   		warn("InputContext bulunamadı!")
   	end
   end)

4. UpdateContext scripti yerleştirildiğinde, bir adlandırılmış InputContext'ı bağlanabilir olayı ateşleyerek güncelleyebilirsiniz; örneğin bir LocalScript üzerinden, bir GuiButton'ı bir ScreenGui konteyneri içinde çalıştıran bir yerleştirme.

   

   Buton Betiği
   local ReplicatedStorage = game:GetService("ReplicatedStorage")
   
   local inputsFolder = ReplicatedStorage:WaitForChild("Inputs")
   local contextEvent = inputsFolder:WaitForChild("ContextEvent")
   
   local button = script.Parent
   button.Activated:Connect(function()
   	-- Hedef girdi bağlamı ve etkin durum ile bağlanabilir olayı tetikleyin
   	contextEvent:Fire("PlayContext", true)
   end)

Varsayılan bağlamalar

Roblox, hareket, kamera kontrolü ve temel çevre etkileşimi için varsayılan giriş bağlama seçenekleri sağlar — Roblox oyuncuları bu kontrollerle tanıdık olduğu için, bunları yalnızca belirli durumlarda geçersiz kılmalısınız. Ayrıca, rezerv girişlerin geçersiz kılınamayacağını ve her zaman amaçlandığı gibi çalışacağını unutmayın.