Unity PlayerPrefs ile Veri Kaydetme: SetInt Kullanımı

Unity PlayerPrefs ile Veri Kaydetme: SetInt Kullanımı

Unity oyun geliştirme sürecinde, kullanıcı ayarlarını, oyun ilerlemesini veya yüksek skorları kaydetmek sıkça karşılaşılan bir ihtiyaçtır. İşte tam bu noktada Unity’nin sunduğu basit ama etkili bir çözüm olan PlayerPrefs devreye girer. Bu makalede, Unity PlayerPrefs sistemini ve özellikle tamsayı değerleri kaydetmek için kullanılan SetInt() metodunu derinlemesine inceleyeceğiz. Temel kullanımdan pratik ipuçlarına, yaygın hatalardan performans notlarına kadar her şeyi bulacaksınız.

PlayerPrefs Nedir ve Neden Kullanılır?

PlayerPrefs, Unity oyunlarında küçük ve basit verileri kalıcı olarak depolamak için tasarlanmış bir anahtar-değer (key-value) depolama sistemidir. Bu sistem, oyuncu cihazında platforma özgü bir konumda (Windows’ta kayıt defteri, macOS’ta plist dosyaları, mobil cihazlarda XML dosyaları vb.) veri saklar. Amacı, oyunun kapatılıp açılmasına rağmen belirli bilgilerin korunmasını sağlamaktır.

Unity PlayerPrefs, genellikle aşağıdaki senaryolarda tercih edilir:

• Oyun içi ayarlar (ses seviyesi, grafik kalitesi, dil seçimi).
• En yüksek skorlar.
• Oyuncunun kaldığı seviye veya ilerleme durumu.
• Basit envanter öğeleri veya kilidi açılmış içerikler.

Büyük ve karmaşık veri yapıları (örneğin, kapsamlı bir envanter sistemi veya çok oyunculu veriler) için PlayerPrefs yerine JSON, XML serileştirme veya veritabanı çözümleri gibi daha gelişmiş yöntemler düşünülmelidir. Ancak basit ve hızlı kayıt işlemleri için PlayerPrefs idealdir.

PlayerPrefs.SetInt() Metodu: Temeller

PlayerPrefs sınıfı, int, float ve string olmak üzere üç temel veri tipini depolamanıza olanak tanır. Bu makalede odak noktamız olan SetInt() metodu, bir tamsayı değerini (integer) belirtilen bir anahtar ile kaydetmek için kullanılır.

Sözdizimi:

PlayerPrefs.SetInt("anahtarAdı", değer);

Burada:

• "anahtarAdı": Kaydedilecek veriyi tanımlayan benzersiz bir string anahtarıdır. Bu anahtar ile daha sonra veriyi geri alacaksınız.
• değer: Kaydedilecek olan tamsayı değeridir (örneğin, 100, 5, -20).

Örnek Kullanım: Oyuncu Puanını Kaydetme

Bir oyuncunun skorunu kaydetmek istediğimizi varsayalım:

using UnityEngine;

public class ScoreManager : MonoBehaviour
{
    public int currentScore = 0;
    private const string ScoreKey = "OYUNCU_PUANI"; // Anahtarımızı tanımladık

    void Start()
    {
        // Oyuncunun daha önce kaydettiği puanı yükle
        currentScore = PlayerPrefs.GetInt(ScoreKey, 0); // Varsayılan değer 0
        Debug.Log("Yüklenen Puan: " + currentScore);
    }

    public void AddScore(int amount)
    {
        currentScore += amount;
        Debug.Log("Yeni Puan: " + currentScore);

        // Puanı kaydet
        PlayerPrefs.SetInt(ScoreKey, currentScore);
        
        // Değişiklikleri kalıcı hale getir
        PlayerPrefs.Save(); 
    }

    // Uygulama kapatıldığında veya duraklatıldığında da kaydetmek iyi bir pratiktir.
    void OnApplicationQuit()
    {
        PlayerPrefs.SetInt(ScoreKey, currentScore);
        PlayerPrefs.Save();
    }

    void OnApplicationPause(bool pauseStatus)
    {
        if (pauseStatus)
        {
            PlayerPrefs.SetInt(ScoreKey, currentScore);
            PlayerPrefs.Save();
        }
    }
}

Yukarıdaki örnekte, AddScore metodu çağrıldığında currentScore güncelleniyor ve ardından PlayerPrefs.SetInt(ScoreKey, currentScore); ile kaydediliyor. PlayerPrefs.Save(); çağrısı, yapılan değişikliklerin diske yazılmasını sağlar ve verinin kalıcı olmasını garantiler.

Unity PlayerPrefs ile Çalışmak: Detaylar

Veri Çekme: Kaydettiğiniz bir değeri geri almak için PlayerPrefs.GetInt("anahtarAdı", varsayılanDeğer); metodunu kullanırsınız. İkinci parametre olan varsayılanDeğer çok önemlidir; eğer belirtilen anahtarla bir değer bulunamazsa, bu varsayılan değer döndürülür. Bu, uygulamanızın beklenmedik hatalar vermesini engeller.

PlayerPrefs.Save() Önemi: SetInt() veya diğer Set metodları çağrıldığında, veriler hemen diske yazılmaz; genellikle bellekte tutulur. PlayerPrefs.Save() metodu çağrıldığında ise bu veriler kalıcı olarak diske kaydedilir. Eğer bu metodu çağırmazsanız ve oyun aniden kapanırsa (örneğin, çökme veya batarya bitmesi), en son yaptığınız kayıtlar kaybolabilir. Bu yüzden, kritik kayıt işlemlerinden sonra veya uygulamanın kapanmaya yakın olduğu durumlarda (OnApplicationQuit(), OnApplicationPause()) Save() metodunu çağırmak hayati öneme sahiptir.

Pratik İpuçları ve En İyi Uygulamalar

1. Anahtarlar İçin Sabitler (Constants) Kullanın

Anahtar stringlerini doğrudan kod içinde yazmak yerine, const string veya static readonly string kullanarak tanımlayın. Bu, yazım hatalarını önler ve kodunuzu daha okunaklı ve yönetilebilir hale getirir.

public static class PlayerPrefKeys
{
    public const string PlayerScore = "OYUNCU_PUANI";
    public const string SoundVolume = "SES_SEVIYESI";
    public const string TutorialShown = "EGITIM_GOSTERILDI";
}

// Kullanım:
PlayerPrefs.SetInt(PlayerPrefKeys.PlayerScore, 1500);
int score = PlayerPrefs.GetInt(PlayerPrefKeys.PlayerScore, 0);

2. GetInt() İçin Her Zaman Varsayılan Değer Belirtin

PlayerPrefs.GetInt("anahtar", varsayılanDeğer); metodunda varsayılan değeri belirtmek, ilgili anahtarla daha önce hiçbir değer kaydedilmemiş olsa bile uygulamanızın çökmesini engeller ve öngörülebilir bir başlangıç durumu sağlar.

3. Kayıt İşlemini Doğru Zamanlayın

PlayerPrefs.Save() metodunu her SetInt() çağrısından sonra anında çağırmak, özellikle sık sık veri kaydı yapılan durumlarda performans düşüşüne neden olabilir. Bunun yerine, önemli anlarda (örneğin, bir seviye bittiğinde, oyun duraklatıldığında veya uygulama kapatıldığında) toplu kayıt yapmak daha verimlidir. Ancak, veri kaybı riskini minimize etmek için önemli verilerin kaybolmaması gereken noktalarda kayıt yapmayı unutmayın.

4. Veri Varlığını Kontrol Edin (PlayerPrefs.HasKey())

Bazen bir anahtarın var olup olmadığını kontrol etmek isteyebilirsiniz. Örneğin, bir eğitimin daha önce gösterilip gösterilmediğini anlamak için:

if (!PlayerPrefs.HasKey(PlayerPrefKeys.TutorialShown))
{
    // Eğitim daha önce gösterilmemiş, şimdi göster
    ShowTutorial();
    PlayerPrefs.SetInt(PlayerPrefKeys.TutorialShown, 1); // Gösterildi olarak işaretle
    PlayerPrefs.Save();
}

5. Geliştirme Sırasında PlayerPrefs’i Temizleme

Test aşamasında kayıtlı verileri sıfırlamak isteyebilirsiniz. Bunun için PlayerPrefs.DeleteAll(); veya belirli bir anahtarı silmek için PlayerPrefs.DeleteKey("anahtarAdı"); metodlarını kullanabilirsiniz. Ancak, bu metodları canlı oyunda dikkatli kullanmalısınız, zira oyuncu verilerini kalıcı olarak silebilirler.

Yaygın Hatalar ve Çözümleri

• PlayerPrefs.Save()‘i Unutmak: En yaygın hatalardan biridir. Verilerin diske yazılmadığı için oyun kapatıldığında kaybolmasına neden olur. Çözüm: Kritik kayıt işlemlerinden sonra veya OnApplicationQuit()/OnApplicationPause() içinde düzenli olarak Save() çağırın.
• Anahtar İsimlerinde Yazım Hataları: Kaydederken bir anahtar, çekerken farklı bir anahtar adı kullanmak, veriye ulaşılamamasına neden olur. Çözüm: Anahtarlar için sabitler (constants) kullanın.
• GetInt()‘e Varsayılan Değer Vermemek: Eğer bir anahtar mevcut değilse ve varsayılan değer belirtmezseniz, GetInt() varsayılan olarak 0 döndürür. Bu her zaman istediğiniz davranış olmayabilir. Çözüm: Her zaman anlamlı bir varsayılan değer belirtin.
• Hassas veya Büyük Veriler İçin Kullanmak: PlayerPrefs verileri şifrelemez ve okunabilir metin olarak saklar. Hassas bilgileri (şifreler, kişisel veriler) veya çok büyük veri setlerini (kompleks envanter sistemleri) PlayerPrefs ile saklamak güvenlik açıkları veya performans sorunları yaratabilir. Çözüm: Bu tür veriler için daha güvenli ve ölçeklenebilir serileştirme/veritabanı çözümlerini tercih edin.

Performans ve Optimizasyon Notları

Unity PlayerPrefs, küçük veri parçacıkları için oldukça hızlı ve verimlidir. Ancak, her Set ve Get işlemi bir miktar CPU ve I/O maliyeti getirir. Bu nedenle:

• Çok sık (örneğin, her karede) SetInt() veya GetInt() çağırmaktan kaçının.
• PlayerPrefs.Save()‘i gereksiz yere sık çağırmayın. Toplu kayıt stratejileri geliştirin.
• PlayerPrefs‘in sağladığı güvenlik seviyesi düşüktür. Veriler kolayca değiştirilebilir veya okunabilir. Eğer oyununuz için daha yüksek güvenlik gereksinimleri varsa, verileri şifrelemeyi veya sunucu tabanlı depolama çözümlerini düşünün.

Sonuç

Unity PlayerPrefs, oyunlarınızda basit ve kalıcı veri depolama ihtiyaçlarınız için güçlü ve kolay kullanımlı bir araçtır. Özellikle PlayerPrefs.SetInt() metodu ile tamsayı değerlerini kaydetmek, yüksek skorlar, ayarlar veya temel oyun ilerlemesi gibi birçok senaryoda size büyük kolaylık sağlar. Bu makaledeki ipuçlarını ve en iyi uygulamaları takip ederek, oyunlarınız için sağlam ve güvenilir bir kayıt sistemi oluşturabilirsiniz. Unutmayın, doğru aracı doğru amaç için kullanmak, başarılı bir oyun geliştirme sürecinin anahtarıdır.