Bloga Dön

Unity'nin Eski Input Manager Sisteminden Yeni Input System'e Kontrolleri Bozmadan Nasıl Geçiş Yapılır

Yayınlanma tarihi 20 Kasım 2026
Unity'nin Eski Input Manager Sisteminden Yeni Input System'e Kontrolleri Bozmadan Nasıl Geçiş Yapılır Yapay zekâ yardımıyla oluşturuldu

Özet olarak

Unity 6 projesini eski Input Manager'dan Input System'e oyuncu kontrolleri, UI veya kalan Input çağrılarını bozmadan nasıl taşıyacağınızı öğrenin.

Input System'i yüklüyorsunuz, Play'e basıyorsunuz ve Unity bir hata veriyor: UnityEngine.Input sınıfıyla girdi okumaya çalışıyorsunuz ama Active Input Handling zaten Input System paketine işaret ediyor. Ya da Play Mode başlıyor ama duraklat menüsü artık tek bir tıklamayı bile algılamıyor.

Bu makale, mevcut bir Unity 6 projesini eski Input Manager'dan yeni Input System'e kontrolleri veya UI'ı bozmadan güvenli bir sırayla taşımayı gösteriyor. Her iki arka ucu açık tutun, Input çağrılarınızı değiştirin, EventSystem'i düzeltin, ardından her şey hala çalışırken eski yöneticiyi kapatın. Adımlar 20 Kasım 2026 tarihi itibarıyla resmi Input System dokümantasyonunu takip ediyor. Mevcut Input System paketini Package Manager'dan yükleyin. Bu makaledeki paket sürümünü sabitlemeyin, çünkü daha yeni sürümler çıkacak.

Unity 6'da neden geçiş yapmalı

Unity'nin kılavuzu artık yerleşik Input Manager'ı eski bir özellik olarak ele alıyor. Kullanımdan kaldırıldı, yeni projeler için önerilmiyor ve Unity editörün gelecekteki bir sürümünde kaldırılacağını söylüyor. Eski yönetici mevcut projelerin çalışmaya devam edebilmesi için hala kullanılabilir durumda. Planlı bir geçiş, gelecekteki bir güncellemenin eski arka ucu sizin için kaldırmasını beklemekten daha iyi.

Geçiş yaparken her iki arka ucu açık tutun

Projeniz Input System içermiyorsa, Window > Package Manager'ı açın, Unity Registry'ye geçin ve Input System paketini yükleyin. Unity 6.1'den itibaren bazı proje şablonları bunu zaten ekliyor. Boş projeler genellikle eklemiyor.

Yükleme sırasında Unity, Input System arka uçlarını etkinleştirip Input Manager arka uçlarını devre dışı bırakmak isteyip istemediğinizi sorar. Evet'i seçerseniz, Editör yalnızca yeni sistem aktifken yeniden başlar. Kalan her Input.GetAxis veya Input.GetButton çağrısı başarısız olur ve hala eski input modülünü kullanan uGUI menüleri de onlarla birlikte başarısız olur.

Arka ucu kendiniz ayarlayın. Edit > Project Settings > Player'a gidin, Other Settings'i açın ve Active Input Handling'i Both olarak ayarlayın. Editör yeniden başlayacak. Bu modda Unity hem ENABLE_LEGACY_INPUT_MANAGER hem de ENABLE_INPUT_SYSTEM tanımlar, böylece eski ve yeni kod yan yana çalışabilir.

#if ENABLE_INPUT_SYSTEM
    // New Input System backends are enabled.
#endif

#if ENABLE_LEGACY_INPUT_MANAGER
    // Old Input Manager backends are enabled.
#endif

Both seçeneğini bir köprü olarak ele alın. Kendi scriptleriniz, EventSystem ve tüm üçüncü taraf assetler geçiş yapana kadar açık bırakın. Yalnızca Play Mode ve build istisna olmadan ve çalışan bir UI ile çalıştıktan sonra Input System Package (New) seçeneğine geçin.

GetAxis ve GetButton'ı Actions ile değiştirin

Önerilen iş akışı, ham cihaz düğmelerini değil adlandırılmış eylemleri okumaktır. Birden fazla action asset'ine ihtiyacınız yoksa, tek bir asset'i proje genelinde kullanılacak eylemler olarak atayın.

Edit > Project Settings > Input System Package'ı açın ve hiçbiri ayarlanmamışsa varsayılan proje geneli eylemleri oluşturun veya atayın. Varsayılanlar bir Player haritası ve bir UI haritası içerir, Move (bir Vector2 değeri) ve Jump gibi eylemlerle birlikte, klavye, fare, gamepad, dokunma ve XR için zaten bağlanmış. Bunlara InputSystem.actions aracılığıyla ulaşırsınız. Varsayılan olarak etkinleştirilirler ve başlangıçta ön yüklenir, Editörde ise her Play Mode'a girdiğinizde.

Her eylemi bir kez bulun, ardından her karede okuyun. Input.GetAxis("Horizontal") yaptığı gibi her seferinde eylemi ada göre aramak, yeni API'de yavaş yoldur.

using UnityEngine;
using UnityEngine.InputSystem;

public class PlayerMovement : MonoBehaviour
{
    InputAction moveAction;
    InputAction jumpAction;

    void Start()
    {
        moveAction = InputSystem.actions.FindAction("Move");
        jumpAction = InputSystem.actions.FindAction("Jump");
    }

    void Update()
    {
        Vector2 move = moveAction.ReadValue<Vector2>();
        if (jumpAction.WasPressedThisFrame())
        {
            // jump
        }
    }
}

UnityEngine.InputSystem ad alanındaki isimler eski çağrılarla şu şekilde eşleşir:

  • Input.GetAxis("Horizontal") ve Input.GetAxis("Vertical") moveAction.ReadValue<Vector2>() olur
  • Input.GetButton("Jump") jumpAction.IsPressed() olur
  • Input.GetButtonDown WasPressedThisFrame() olur
  • Input.GetButtonUp WasReleasedThisFrame() olur
  • Input.GetKey(KeyCode.Space) Keyboard.current.spaceKey.isPressed olur
  • Input.GetMouseButton(0) Mouse.current.leftButton.isPressed olur
  • Input.mousePosition Mouse.current.position.ReadValue() olur

Kontrollerin aynı hissettirmesini istiyorsanız iki detay önemlidir. Varsayılan Move eylemi 2D bir değerdir, dolayısıyla eski Horizontal ve Vertical eksenleri iki float değil tek bir vektör olur. Ve ReadValue eski Gravity ve Sensitivity yumuşatmasını uygulamaz, bu nedenle bir tuş veya düğme anında tam değerine ulaşır. Hareketiniz bu yokuşa dayanıyorsa, bunu bilerek yeniden oluşturmanız gerekir. Input.GetAxisRaw'ın doğrudan bir karşılığı yoktur. ReadUnprocessedValue() yalnızca eyleme işlemciler eklendiğinde ReadValue'dan farklıdır.

Keyboard.current gibi doğrudan cihaz okumaları hızlı bir geçici çözümdür, uzun vadeli iş akışı değildir ve bu donanım eksik olduğunda geçerli cihaz null olabilir.

Birkaç eski Input Manager özelliği hala Unity sürümünüze bağlıdır. Unity 6.4'ten itibaren OnMouseDown gibi MonoBehaviour fare olay fonksiyonları Input System ile çalışır. Daha önceki Unity 6 sürümlerinde yalnızca yeni arka uç aktifken hiçbir şey yapmayabilirler. Projeniz konum, pusula veya cihaz yönelimi kullanıyorsa, eski yöneticiyi kapatmadan önce editörünüz için Input System dokümantasyonunu kontrol edin. IMGUI (OnGUI) Input System ile uyumlu değildir, bu nedenle bu şekilde oluşturulmuş bir hata ayıklama menüsünün Both üzerinde kalması gerekebilir.

UI'ın çalışmasını sağlayın

Unity UI (uGUI) kullanıyorsanız, Input System'i UI'a beslemek için EventSystem'de her zaman bir input modülüne ihtiyacınız vardır. Daha eski StandaloneInputModule hala eski Input Manager ile konuşur. Active Input Handling yalnızca yeni pakete ayarlandığında, bu modül UnityEngine.Input istisnasının sık görülen bir kaynağıdır.

Sahnedeki EventSystem'i seçin. Input System paketi yüklüyse, Inspector StandaloneInputModule'ü InputSystemUIInputModule ile değiştiren bir düğme sunar. Yeni modül varsayılan UI eylemleriyle önceden yapılandırılmış olarak gelir. Active Input Handling zaten yeni pakete veya Both'a ayarlıyken, sahneye yeni bir uGUI öğesi yerleştirdiğinizde Unity yeni modülü otomatik olarak ekler.

UI Toolkit farklıdır. Unity 2023.2'den itibaren (Unity 6'yı içerir), UI Toolkit ekstra bir modül olmadan proje geneli eylemlerinizdeki UI eylemlerini okuyabilir. UI Toolkit ve uGUI aynı sahneyi paylaştığında InputSystemUIInputModule artı bir EventSystem'e ihtiyacınız olur.

PlayerInput bileşenini de kullanıyorsanız, aynı action asset'ini PlayerInput'a ve InputSystemUIInputModule'e atayın ve PlayerInput üzerindeki UI Input Module alanını ayarlayın. Böylece aynı cihaz ataması hem oyuncuyu hem de UI'ı yönlendirir. PlayerInput kullanımdayken scriptleriniz eylemleri okuyorsa, InputSystem.actions'ı değil PlayerInput.actions'ı okuyun, çünkü PlayerInput her oyuncunun cihazı için filtrelenmiş bir kopya tutar.

İstisna ve kalan Input çağrıları

Çalışma zamanı hatası genellikle şöyle okur: InvalidOperationException: You are trying to read Input using the UnityEngine.Input class, but you have switched active Input handling to Input System package in Player Settings. Active Input Handling Input System Package (New) olarak ayarlandığında ve bir şey hala UnityEngine.Input çağırdığında görünür.

Rastgele scriptleri değiştirmeden önce yığın izini okuyun. Genellikle hareket sınıfınızda değil StandaloneInputModule veya BaseInput.GetButtonDown'da başlar. EventSystem'i düzelttikten sonra kendi kodunuzda Input.GetAxis, Input.GetButton, Input.GetKey, Input.GetMouseButton ve Input.mousePosition arayın. Ardından üçüncü taraf assetleri ve eklentileri kontrol edin. Active Input Handling'i Both'a geri ayarlamak geçerli geçici bir adımdır. Kalıcı çözüm, çağrıyı geçirmek veya eklentiyi güncellemektir.

PlayerInput ne zaman değerlidir

PlayerInput bileşeni isteğe bağlıdır. Send Messages (OnJump, OnMove(InputValue value)), Invoke Unity Events veya yerel çok oyunculu için PlayerInputManager istediğinizde ekleyin. Update'te zaten yoklama yapan tek oyunculu bir oyun FindAction ve ReadValue ile kalabilir.

Kısa bir geçiş kontrol listesi

  1. Package Manager'dan mevcut Input System paketini yükleyin, ardından Active Input Handling'i Both olarak ayarlayın.
  2. Varsayılan proje geneli eylemleri oluşturun veya atayın.
  3. Kendi Input çağrılarınızı değiştirin. Her eylemi bir kez bulun, ardından her karede okuyun.
  4. uGUI kullanıyorsanız, StandaloneInputModule'ü InputSystemUIInputModule ile değiştirin ve menülerde klavye ve gamepad ile tıklayın.
  5. OnMouse olaylarını, dokunmayı, konumu, pusulayı ve IMGUI'yi Unity sürümünüze göre kontrol edin.
  6. Hala UnityEngine.Input çağıran eklentileri güncelleyin veya bir düzeltme bulunana kadar Both açık bırakın.
  7. Play Mode ve build istisna olmadan ve çalışan bir UI ile çalıştığında, Active Input Handling'i Input System Package (New) olarak ayarlayın.

Son anahtarı çevirmeden önce hareket, menüler ve ekran düğmelerini test edin. Input istemci tarafı bir motor konusudur. horizOn hesaplar, bulut kayıt, lider tabloları ve oyun içi haberler için Unity SDK'sına sahip bir oyun arka ucudur. Input System'i geçirmek bu SDK'yı nasıl kullandığınızı değiştirmez ve Unity'nin input yığınını değiştirmez veya sarmaz.