Unity’de JsonUtility.ToJson() Metodu ile Veri Serializasyonu

Unity oyun geliştirme sürecinde, oyun verilerini kalıcı olarak saklamak, farklı platformlar arasında aktarmak veya ağ üzerinden iletişim kurmak için sıklıkla veri serializasyonuna ihtiyaç duyarsınız. JSON (JavaScript Object Notation), hafif, okunabilir ve birçok programlama dili tarafından desteklenen popüler bir veri değişim formatıdır. Unity, bu ihtiyacı karşılamak için JsonUtility sınıfını sunar. Bu makalede, JsonUtility.ToJson() metodunu kullanarak verileri JSON formatına nasıl dönüştüreceğinizi detaylı olarak ele alacağız.

JsonUtility.ToJson() Metodunun Temelleri

JsonUtility.ToJson() metodu, Unity’de C# nesnelerini JSON formatlı metinlere dönüştürmenizi sağlar. Bu işlem, serializasyon olarak adlandırılır. Metodun temel kullanım şekli oldukça basittir:

public class OyuncuVerisi
{
    public string ad;
    public int can;
    public int puan;
}

// ...

OyuncuVerisi oyuncu = new OyuncuVerisi();
oyuncu.ad = "Ahmet";
oyuncu.can = 100;
oyuncu.puan = 500;

string jsonVerisi = JsonUtility.ToJson(oyuncu);
Debug.Log(jsonVerisi); // Çıktı: {"ad":"Ahmet","can":100,"puan":500}

Yukarıdaki örnekte, OyuncuVerisi adlı bir sınıf tanımlıyoruz ve bu sınıftan bir nesne oluşturup değerlerini atayıp daha sonra JsonUtility.ToJson() metodu ile JSON formatına dönüştürüyoruz. Sonuç olarak, {"ad":"Ahmet","can":100,"puan":500} şeklinde bir JSON metni elde ederiz.

JsonUtility.ToJson() ile İleri Seviye Kullanım

Özellikleri Özelleştirme

JsonUtility.ToJson() metodu, ikinci bir parametre alarak JSON çıktısının biçimlendirmesini kontrol etmenizi sağlar. JsonUtility.ToJson(nesne, güzelBiçimlendirme) şeklinde kullanılır. güzelBiçimlendirme parametresi true ise, çıktı daha okunabilir bir şekilde girintili olarak oluşturulur; false ise tek satırda sıkıştırılmış bir JSON metni elde edilir.

string jsonVerisiGirintisiz = JsonUtility.ToJson(oyuncu, false);
Debug.Log(jsonVerisiGirintisiz); // Çıktı: {"ad":"Ahmet","can":100,"puan":500}

string jsonVerisiGirintili = JsonUtility.ToJson(oyuncu, true);
Debug.Log(jsonVerisiGirintili); // Çıktı: {
  "ad": "Ahmet",
  "can": 100,
  "puan": 500
}

Sınıf Yapısı Kısıtlamaları

JsonUtility sınıfı ile serializasyon yaparken bazı kısıtlamalar vardır. Sınıflarınızın public alanlara sahip olması ve nesne referanslarını doğru bir şekilde yönetmeniz gerekir. JsonUtility, diziler, temel veri tipleri (int, float, string, bool) ve diğer JsonUtility tarafından desteklenen sınıfları serializasyon yapabilir. Karmaşık nesneler için, [Serializable] özniteliğini kullanmanız gerekebilir.

[Serializable]
public class Envanter
{
    public string[] eşyalar;
}

JsonUtility.ToJson() ile Veri Kaydetme ve Yükleme

JsonUtility.ToJson() ile oluşturduğunuz JSON verilerini, dosya sistemine kaydedebilir ve daha sonra JsonUtility.FromJson() metodu ile tekrar yükleyebilirsiniz. Bu, oyun verilerinizi kalıcı olarak saklamanız için ideal bir yöntemdir. Örneğin, oyuncunun ilerlemesini bir dosyaya kaydedebilirsiniz.

// Verileri dosyaya kaydetme
string yol = Application.persistentDataPath + "/oyuncuVerisi.json";
System.IO.File.WriteAllText(yol, jsonVerisi);

// Verileri dosyadan yükleme
string json = System.IO.File.ReadAllText(yol);
OyuncuVerisi yuklenenOyuncu = JsonUtility.FromJson<OyuncuVerisi>(json);

Önemli Notlar

Performans: Çok büyük veri setleri için JsonUtility performans sorunlarına yol açabilir. Bu durumlarda, daha performanslı serializasyon çözümlerine (örneğin, LitJson veya Newtonsoft.Json) yönelmeniz gerekebilir.

Hata Yönetimi: JsonUtility.ToJson() metodu hata fırlatmaz. Hataları yakalamak için JSON verilerini doğrulamanız gerekebilir.

Bu makalede, JsonUtility.ToJson() metodunu kullanarak Unity’de veri serializasyonunu nasıl yapacağınızı öğrendiniz. Bu yöntem, basit ve orta karmaşıklığa sahip veri yapıları için kullanışlı bir çözümdür. Daha karmaşık senaryolar için farklı serializasyon kütüphanelerini araştırabilirsiniz.