Unity'nin ObjectPool'ı

Unity, UnityEngine.Pool içindeki ObjectPool<T> havuzunu sunar. Dört lambda ile her adımda ne yapacağını belirtirsin; havuz da yedek nesneleri ve sayaçları yönetir. Bu baca her 0.2 saniyede bir duman püskürtür ve her duman püskürtüsü bir saniye sonra havuza geri döner:

using UnityEngine;
using UnityEngine.Pool;

public class Chimney : MonoBehaviour
{
    public Puff puffPrefab;
    private ObjectPool<Puff> pool;
    private float timer;

    void Awake()
    {
        pool = new ObjectPool<Puff>(
            createFunc: () => Instantiate(puffPrefab),
            actionOnGet: puff => puff.gameObject.SetActive(true),
            actionOnRelease: puff => puff.gameObject.SetActive(false),
            actionOnDestroy: puff => Destroy(puff.gameObject),
            collectionCheck: true,
            defaultCapacity: 10,
            maxSize: 20);
    }

    void Update()
    {
        timer += Time.deltaTime;
        if (timer >= 0.2f)
        {
            timer = 0f;
            Puff puff = pool.Get();
            puff.transform.position = transform.position + Vector3.up;
            puff.Launch(pool);
        }
    }
}

// Puff.cs
private IObjectPool<Puff> pool;
private float age;

public void Launch(IObjectPool<Puff> owner)
{
    pool = owner;
    age = 0f;
}

void Update()
{
    transform.Translate(0f, Time.deltaTime, 0f);
    age += Time.deltaTime;
    if (age >= 1f) pool.Release(this);
}

createFunc, Get havuzun boş olduğunu bulduğunda çalışır; actionOnGet her Get çağrısında, actionOnRelease ise her Release çağrısında çalışır. maxSize kadar yedek nesne zaten beklerken bir duman püskürtüsü serbest bırakılırsa havuz onu saklamaz: actionOnDestroy onu yok eder. defaultCapacity yalnızca havuz listesinin başlangıç boyutudur; dolayısıyla başlangıçta hiçbir nesne oluşturulmaz. CountAll, havuzun oluşturduğu ve hâlâ sahip olduğu duman püskürtülerinin sayısını; CountActive, oyunda olanların sayısını; CountInactive ise yedeklerin sayısını tutar. Get, baca onu yerleştirmeden önce duman püskürtüsünü etkinleştirir; burada sorun olmaz, çünkü Puff'ın konumunu okuyan bir OnEnable metodu yoktur. Duman püskürtüsü havuzu, her Unity havuzunun uyguladığı arayüz olan IObjectPool<Puff> olarak saklar ve Launch, her kullanımda yaşını sıfırlar.

collectionCheck açıkken, havuzda zaten bulunan bir duman püskürtüsünü serbest bırakmak bir InvalidOperationException hatasına yol açar: Trying to release an object that has already been released to the pool. Kontrol yalnızca Editor'de çalışır; çünkü her Release çağrısında yedekleri arar. Derlemede duman püskürtüsü havuzda iki kez bulunur ve iki Get çağrısı aynı nesneyi verir. Bunun yaygın bir nedeni, serbest bırakıldıktan sonra çalışmayı sürdürüp kendini tekrar serbest bırakan bir nesnedir; bu yüzden actionOnRelease nesneyi devre dışı bırakır.