Oyun Tasarımı Destek Sitesi

Merhabalar,

Bu kısa derste, Unity‘de JsonUtility kullanarak JSON veri okumayı ve kaydetmeyi göreceğiz.

Hızlıca derse başlayalım!

JsonUtility, hem hız hem de GC (garbage collection) anlamında, piyasadaki diğer popüler JSON kütüphanelerinden daha performanslıdır ancak maalesef JsonUtility her veri türünü desteklemez, sadece Unity’nin serialize edebildiği türleri destekler.

Desteklenen Veri Türleri

• int, float vs. primitive türler
• Vector3, Quaternion gibi temel Unity struct’ları
• tek boyutlu array (int[] desteklenirken int[,] ve int[][] desteklenmez)
• List
• MonoBehaviour veya ScriptableObject‘ten türeyen sınıflar
• System.Serializable attribute’üne sahip class ve struct’lar

Desteklenmeyen Veri Türleri

• Dictionary gibi, Unity’nin serialize edemediği türler; eğer yazdığınız bir script’teki public A obje; değişkeni Inspector’da gözükmüyorsa, Unity A türünü serialize edemiyordur ve haliyle bu tür JsonUtility tarafından desteklenmez
• Transform, Rigidbody gibi çoğu Unity component’i (bu component’ler MonoBehaviour‘dan değil Component‘ten türerler)
• Property’ler desteklenmez

Şimdi dilerseniz bir örnek üzerinden, JsonUtility’nin nasıl çalıştığını görelim. Şöyle bir sınıfımız olsun:

// Bu sınıf JsonUtility'i destekler çünkü System.Serializable attribute'üne sahip
[System.Serializable]
public class JSONTest
{
	// JSON'a dahil olur: tek boyutlu array desteklenir ve değişken public
	public int[] array = new int[2] { 11, 13 };
		
	// JSON'a dahil olur: temel Unity struct'ları desteklenir ve
	// değişken private olmasına rağmen SerializeField attribute'üne sahip
	[SerializeField]
	private Vector3 vektor = new Vector3( 1f, 0f, 2f );

	// JSON'a dahil olmaz: primitive türler desteklenir ancak değişken private
	private float sayi = 3.14f;

	// JSON'a dahil olmaz: Dictionary desteklenmez ve değişken private
	public Dictionary<string, int> dictionary = new Dictionary<string, int>();

	// JSON'a dahil olmaz: string desteklenir ve değişken public ancak değişken
	// System.NonSerialized attribute'üne sahip
	[System.NonSerialized]
	public string yazi = "Test";
}

Bir objeyi JSON formatına çevirmek için JsonUtility.ToJson fonksiyonu kullanılır:

void Start()
{
	// Yeni bir JSONTest objesi oluştur ve bunu JSON'a çevir
	string json = JsonUtility.ToJson( new JSONTest() );

	// Oluşturulan JSON'u konsola yazdır
	Debug.Log( json );
}

Konsola şu JSON bastırılır:

{"array":[11,13],"vektor":{"x":1.0,"y":0.0,"z":2.0}}

JsonUtility.ToJson fonksiyonu tercihe bağlı bir 2. parametre alır. Eğer bu parametre true olursa, oluşturulan JSON daha okunabilir bir formatta olur:

// Yeni bir JSONTest objesi oluştur ve bunu JSON'a çevir
string json = JsonUtility.ToJson( new JSONTest(), true );

{
    "array": [
        11,
        13
    ],
    "vektor": {
        "x": 1.0,
        "y": 0.0,
        "z": 2.0
    }
}

NOT: JsonUtility.ToJson fonksiyonu sadece, MonoBehaviour veya ScriptableObject‘ten türeyen sınıflar ile System.Serializable attribute’üne sahip class ve struct’ları JSON’a çevirebilir, bunlar harici objeler için (array, List, int, Vector3 vb.) boş bir JSON döndürür. Bu yüzden diyelim bir array’i JSON’a çevirmek istiyorsanız, içerisinde bu array’i değişken olarak tutan ve System.Serializable attribute’üne sahip bir class veya struct oluşturup onu JsonUtility.ToJson’a parametre olarak vermelisiniz.

JSON veriyi geri objeye çevirmek için, JsonUtility.FromJson fonksiyonu kullanılır:

void Start()
{
	/// JSON OLUŞTURMA
	// Yeni bir JSONTest objesi oluştur ve bunu JSON'a çevir
	string json = JsonUtility.ToJson( new JSONTest() );
		
	/// JSON'U GERİ OBJEYE DÖNÜŞTÜRME
	// Tercih edilen yöntem
	JSONTest obje = JsonUtility.FromJson<JSONTest>( json );
	// Alternatif yöntem
	JSONTest obje2 = (JSONTest) JsonUtility.FromJson( json, typeof( JSONTest ) );
}

Alternatif bir yöntem ise, JsonUtility.FromJson’ın bize yeni bir obje döndürmesi yerine, zaten var olan bir objenin değişkenlerinin üzerine yazmaktır. Bunun için, JsonUtility.FromJsonOverwrite fonksiyonu kullanılır:

void Start()
{
	/// JSON OLUŞTURMA
	// Yeni bir JSONTest objesi oluştur ve bunu JSON'a çevir
	string json = JsonUtility.ToJson( new JSONTest() );

	/// JSON'U GERİ OBJEYE DÖNÜŞTÜRME
	// Yeni bir JSONTest objesi oluştur
	JSONTest obje = new JSONTest();
	// Bu objenin değişkenlerinin değerlerini, JSON'dan okunan değerlerle değiştir
	JsonUtility.FromJsonOverwrite( json, obje );
}

Bu fonksiyon genelde MonoBehaviour veya ScriptableObject’ten türeyen objeler için kullanılır. Böylece sahnedeki bir component’in veya bir ScriptableObject asset’inin değişkenlerinin değerlerini JSON olarak kaydedip daha sonra tekrar yükleyebilirsiniz. Eğer JsonUtility.FromJson kullanmaya çalışırsak, herhangi bir GameObject’in component’i olmayan bir MonoBehaviour oluşturulamayacağı için, fonksiyon hata (exception) verir.

JsonUtility her ne kadar UnityEngine.Object türündeki değişkenleri (Component, ScriptableObject, Material vb.) desteklese de, ben bu türlerde değişkenler kullanmanızı önermem. Sebebini ise bir örnekle göstereyim:

[System.Serializable]
public class JSONTest2
{
	public Transform degisken;
}

void Start()
{
	JSONTest2 obje = new JSONTest2();
	obje.degisken = Camera.main.transform; // Değişkene değer olarak kamerayı ver

	// Objeyi JSON'a çevir
	string json = JsonUtility.ToJson( obje );

	// JSON'u konsola yazdır
	Debug.Log( json );
}

Bu kod, konsola şu JSON’u yazdırır:

{"degisken":{"instanceID":11914}}

Gördüğünüz üzere, Object türündeki değişkenler instanceID‘leri ile JSON’a dahil olurlar. Buradaki sıkıntı ise şu: oyunu her kapayıp açtığınızda, objenin instanceID’si değişir. Örneğin editörü kapatıp açınca bu sefer şu JSON oluşturuldu:

{"degisken":{"instanceID":19068}}

Son olarak da, JSON verinizi dosyada tutmak isterseniz, File.WriteAllText ve File.ReadAllText fonksiyonlarını kullanabilirsiniz (kodun başına using System.IO; yazmayı unutmayın):

private void Start()
{
	// Hedef JSON'ımız, persistentDataPath konumundaki veri.json dosyası
	string jsonKonum = Path.Combine( Application.persistentDataPath, "veri.json" );

	/// JSON OLUŞTURMA
	// Yeni bir JSONTest objesi oluştur ve bunu JSON'a çevir
	string json = JsonUtility.ToJson( new JSONTest() );
	// JSON'u dosyaya yaz
	File.WriteAllText( jsonKonum, json );

	/// JSON'U GERİ OBJEYE DÖNÜŞTÜRME
	// JSON dosyasının var olduğundan emin ol
	if( File.Exists( jsonKonum ) )
	{
		// JSON'u dosyadan oku
		string okunanJson = File.ReadAllText( jsonKonum );
		// Okunan JSON'u objeye çevir
		JSONTest obje = JsonUtility.FromJson<JSONTest>( okunanJson );
	}
}

Bu dersin de sonuna geldik. Bir sonraki dersimizde görüşmek üzere!