기술 자료

Unity 엔진

Unity 엔진

오브젝트 풀링 및 재사용

Unity UnityEngine.Pool API를 사용하여 자주 사용되는 오브젝트를 반복적으로 생성하거나 제거하지 않고 풀링하고 재사용할 수 있도록 CPU 로드와 가비지 컬렉터 오버헤드를 줄일 수 있습니다.
읽는 시간 8분최근 업데이트: 9일 전

오브젝트 풀링 및 재사용은 자주 사용되는 오브젝트의 인스턴스를 풀로 반환하여 검색해서 다시 사용할 수 있는 프로그래밍 패턴입니다. 오브젝트 풀링은 새로운 오브젝트 인스턴스를 반복적으로 인스턴스화하고 제거하여 발생하는 오버헤드를 줄이고, 할당 및 할당 해제의 전체 수를 제한합니다. 이렇게 하면 가비지 컬렉션(GC) 오버헤드가 최소화되고 CPU 부하가 줄어듭니다.
GameObjects 오브젝트를 풀링할 수 있지만, 배열, 리스트, 딕셔너리 등과 같은 자주 사용하는 다른 타입도 풀링할 수 있습니다. 자체 풀링 로직을 작성할 수 있지만 편의를 위해 Unity는 풀링 GameObjects 및 여러 컬렉션 타입을 구현할 수 있는 API 세트를
UnityEngine.Pool
네임스페이스에 제공합니다.
참고
다른 많은 주요 Unity API와 마찬가지로,
UnityEngine.Pool
API는 스레드 세이프가 아니며 메인 스레드에서만 안전하게 호출할 수 있습니다.

풀링 및 GameObjects 재사용

게임에서 발사체와 같은 일부 타입의 오브젝트는 동시에 씬에만 있는 경우에도 반복적으로 자주 나타날 수 있습니다. 게임을 시작할 때 새 발사체 오브젝트가 발사될 때마다 새 발사체 오브젝트를 프리맵에서 인스턴스화하는 대신, 이를 필요에 따라 재사용할 수 있습니다.

오브젝트 풀 생성

Unity의
ObjectPool<T>
클래스는 재사용 가능한 오브젝트 풀 패턴을 구현하며, 애플리케이션에서 오브젝트 풀을 구현하는 가장 간단한 방법입니다.
ObjectPool<T>
의 인스턴스는
T
타입의 오브젝트 풀을 관리합니다.
ObjectPool<T>
생성자
를 통해
ObjectPool<T>
를 생성할 때 풀의 다음 주요 요소를 정의하는 파라미터를 제공합니다.
  • 풀의 시작 용량입니다.
  • 풀이 늘릴 수 있는 최대 용량입니다.
  • 동일한 오브젝트 인스턴스가 풀로 다시 릴리스되지 않도록 수집 안전 검사를 수행하는지 여부.
  • 풀에서 다음과 같은 주요 작업을 수행할 때 Unity가 호출하는 일련의 C#
    Action<T>
    델리게이트입니다.
    • 풀에서 오브젝트를 검색해서 가져올 때 호출하는 콜백입니다.
    • 풀에 오브젝트를 반환할 때 호출하는 콜백입니다.
    • 요청된 경우 풀이 비어있을 때 새 오브젝트 인스턴스를 생성할 때 호출하는 콜백입니다.
    • 풀에 반환되었지만 풀 용량이 최대이면 오브젝트 인스턴스를 파괴할 때 호출하는 콜백입니다.

풀에서 오브젝트 검색

풀에서 오브젝트를 가져오기 위해
ObjectPool<T>.Get
를 호출합니다. 또한 이 작업은
ObjectPool
생성자에
actionOnGet
파라미터로 제공한 메서드를 호출하므로 사용을 위해 오브젝트를 준비하고 활성화할 수 있습니다.
풀이 비어있을 때 풀에서 오브젝트를 요청하면 새 오브젝트 인스턴스가 생성됩니다. 생성 프로세스는
ObjectPool
생성자에
createFunc
파라미터로 제공한 메서드를 호출합니다.
ObjectPool<T>.Get
은 과부하
Get(out PooledObject<T> pooledObject)
입니다.
PooledObject
가 폐기되면 인스턴스를 자동으로 해제합니다. 수명이 짧은 범위에 유용합니다.
자세한 내용과 코드 예제는
PooledObject<T>.Get
API 레퍼런스
를 참조하십시오.

오브젝트를 풀로 반환

오브젝트를 완료하면 반환하는 오브젝트를 인수로 사용하여
ObjectPool<T>.Release
를 호출하여 풀로 반환합니다. 또한 이 작업은
ObjectPool
생성자에
actionOnRelease
파라미터로 제공한 메서드를 호출하여 반환된 객체의 상태를 비활성화하고 재설정할 기회를 제공합니다.
풀이 가득 차면 오브젝트를 풀로 반환하면 오브젝트가 파괴됩니다. 파괴 프로세스는
ObjectPool
생성자에
actionOnDestroy
파라미터로 제공한 메서드를 호출합니다.
생성자에
true
를
collectionCheck
파라미터로 전달하면 수집 안전 검사가 가능합니다. 컬렉션 확인이 활성화되고 이미 풀에 있는 오브젝트를 반환하려고 하면 Unity 예외를 발생시킵니다. 이 옵션을 활성화한 경우에도 컬렉션 확인은 플레이어 빌드가 아니라 에디터에서만 사용할 수 있습니다. 컬렉션 검사를 활성화하면 오버헤드가 추가되지만, 이중 릴리스 오류는 감지되며, 개발 중에 권장됩니다.

사용되는 오브젝트 재설정

풀에서 가져온 오브젝트는 사용 중에 상태를 변경할 수 있습니다. 예를 들어 풀링된 적 게임 오브젝트는 씬에서 활성 상태일 때 포지션, 체력, 애니메이션 상태, 물리 상태를 변경할 수 있습니다. 오브젝트가 풀로 반환될 때 이 상태를 재설정해야 나중에 다시 가져오면 처음 사용 시와 동일한 상태로 시작됩니다.
초기화하는 상태에 따라 오브젝트를
actionOnGet
델리게이트의 풀에서 가져오거나,
actionOnRelease
델리게이트의 풀로 다시 놓으면 오브젝트를 초기화할 수 있습니다. 또 다른 방법은 풀된 오브젝트 자체에 커스텀 비활성화 메서드를 구현하고 풀의 Get 또는 Release 액션에서 해당 메서드를 호출하는 것입니다.
초기화해야 하는 상태는 풀된 오브젝트의 특정 동작과 컴포넌트에 따라 다릅니다. 릴리스 시 일반적인 재설정 작업에는 코루틴 중지, 이벤트 구독 취소, 물리 상태 재설정, 애니메이션 지우기, 파티클 시스템 중지 등이 있습니다. 풀에서 비활성 상태일 때 GameObjects가
Update
호출을 수신하지 않도록 해주는 것도 중요합니다.

예: 발사체 풀링

발사체에 대한 일반적인
ObjectPool<T>
구현에는 다음과 같은 주요 단계가 있습니다.
  1. 게임을 시작할 때 비활성 발사체 오브젝트의 풀을 생성합니다. 풀된 오브젝트를 새로 생성하고, 풀에서 오브젝트를 검색해서 가져오고, 오브젝트를 풀로 다시 놓고, 풀이 가득하므로 오브젝트를 파괴할 때 콜백으로 호출할 수 있는 필수 델리게이트를 생성자에 제공합니다.
  2. 발사체가 필요할 때(예: 사용자가 무기를 발사할 때)
    ObjectPool<T>.Get
    가 있는 풀에서 비활성 발사체를 가져옵니다. 해당
    actionOnGet
    콜백에서 가져온 객체를 활성화하고 해당 위치와 방향과 같은 관련 프로퍼티를 초기화합니다.
  3. 발사체가 더 이상 필요하지 않을 때(예: 타겟에 부딪히거나 경계를 벗어날 때),
    ObjectPool<T>.Release
    로 풀로 반환합니다. 일반적으로 발사체가 완료되면 풀에 대한 레퍼런스를 부여하여 릴리스할 수 있습니다. 해당
    actionOnRelease
    콜백에서 반환된 오브젝트를 비활성화하고 속도 및 애니메이션 상태와 같은 관련 프로퍼티를 재설정합니다.
다음은
ObjectPool<T>
에 풀링된 발사체의 스크립트 컴포넌트 코드입니다. 발사체에는 공용 프로퍼티가 있어 자체 풀에 대한 레퍼런스를 부여하며, 이 프로퍼티를 사용하여 시간 지연 후 풀에 다시 방출됩니다.
using System.Collections; using System.Collections.Generic; using UnityEngine; using UnityEngine.Pool; public class RevisedProjectile : MonoBehaviour { // Deactivate after delay [SerializeField] private float timeoutDelay = 3f; private IObjectPool<RevisedProjectile> objectPool; // Public property to give the projectile a reference to its ObjectPool public IObjectPool<RevisedProjectile> ObjectPool { set => objectPool = value; } public void Deactivate() { StartCoroutine(DeactivateRoutine(timeoutDelay)); } IEnumerator DeactivateRoutine(float delay) { yield는 새 WaitForSeconds(지연)를 반환합니다. // Reset the moving Rigidbody Rigidbody rBody = GetComponent<Rigidbody>(); rBody.linearVelocity = new Vector3(0f, 0f, 0f); rBody.angularVelocity = new Vector3(0f, 0f, 0f); // Release the projectile back to the pool objectPool.Release(this); } }
다음은 발사체를 발사하고 발사체 오브젝트 풀을 관리하는 총 포탑에 연결된 컴포넌트의 코드입니다. 총은 사용자가 발사할 때 오브젝트 풀의
Get
를 호출하여 풀된 발사체를 검색합니다.
using UnityEngine; using UnityEngine.Pool; using UnityEngine.Events; public class RevisedGun : MonoBehaviour { [툴팁("발사 프리맵")] [SerializeField] private RevisedProjectile projectilePrefab; [Tooltip("Projectile force")] [SerializeField] private float muzzleVelocity = 1500f; [툴팁("총이 나타나는 끝 지점")] [SerializeField] private Transform muzzlePosition; [툴팁("발사 사이의 시간 / 작을수록 발사율이 높음")] [SerializeField] private float cooldownWindow = 0.1f; [SerializeField] private UnityEvent m_GunFired; // Stack-based ObjectPool available with Unity 2021 and above private IObjectPool<RevisedProjectile> objectPool; // Throw an exception if we try to return an existing item, already in the pool [SerializeField] private bool collectionCheck = true; // Extra options to control the pool capacity and maximum size [SerializeField] private int defaultCapacity = 20; [SerializeField] private int maxSize = 100; private float nextTimeToShoot; private void Awake() { objectPool = new ObjectPool<RevisedProjectile>(CreateProjectile, OnGetFromPool, OnReleaseToPool, OnDestroyPooledObject, collectionCheck, defaultCapacity, maxSize); } // Invoked when creating an item to populate the object pool private RevisedProjectile CreateProjectile() { RevisedProjectile projectileInstance = Instantiate(projectilePrefab); projectileInstance.ObjectPool = objectPool; return projectileInstance; } // Invoked when returning an item to the object pool private void OnReleaseToPool(RevisedProjectile pooledObject) { pooledObject.gameObject.SetActive(false); } // Invoked when retrieving the next item from the object pool private void OnGetFromPool(RevisedProjectile pooledObject) { pooledObject.gameObject.SetActive(true); } // Invoked when the maximum number of pooled items is exceeded (i.e. destroy the pooled object) private void OnDestroyPooledObject(RevisedProjectile pooledObject) { Destroy(pooledObject.gameObject); } private void FixedUpdate() { // Invokes the Shoot method if the delay time is exceeded if (Input.GetButton("Fire1") && Time.time > nextTimeToShoot && objectPool != null) { Shoot(); } } private void Shoot() { // Get a pooled object instead of instantiating RevisedProjectile bulletObject = objectPool.Get(); if (bulletObject == null) 반환; // Align to gun barrel/muzzle position bulletObject.transform.SetPositionAndRotation(muzzlePosition.position, muzzlePosition.rotation); // Move projectile forward bulletObject.GetComponent<Rigidbody>().AddForce(bulletObject.transform.forward * muzzleVelocity, ForceMode.Acceleration); // Turn off after a few seconds bulletObject.Deactivate(); // Set cooldown delay nextTimeToShoot = Time.time + cooldownWindow; m_GunFired.Invoke(); } }
에셋 스토어)에서 무료 패키지로 다운로드할 수 있습니다. 이 코드를 사용하는 완벽한 작업 예제 프로젝트에는 필요한 모든 프리랩과 풀링된 발사체를 발사하는 작업 포탑이 포함되어 있습니다. 자세한 내용은 Unity에서 C# 스크립트의 성능을 향상시키는 오브젝트 풀링 사용을 참고하십시오.

풀링된 오브젝트에 대한 씬 언로드 처리

기본적으로 오브젝트 풀은 오브젝트가 생성된 씬과 연계됩니다. 해당 씬이 언로드되면 Unity 풀과 풀된 인스턴스를 포함하여 해당 씬의 모든 GameObjects 오브젝트를 파기합니다.
풀 관리자를 호출하는 루트 게임 오브젝트 아래에 배치하여 씬이 다시 로드된 후 오브젝트 풀이 유지되도록 만들 수 있습니다.
object.DontDestroyOnLoad
.
transform.SetParent
을 호출하여 풀 루트 아래에 풀된 항목을 다시 재배치하여 씬으로 파괴되지 않도록 해제할 수 있습니다.
언로드 시 씬에 활성 풀링된 인스턴스가 있을 수 있는 경우 해당 인스턴스가
OnDisable
및
OnDestroy
에서 직접 해제되도록 하거나 항목을 리콜하거나 파괴하기 위해
SceneManager.activeSceneChanged
콜백을 등록해야 합니다.
비활성화하면 풀링된 인스턴스에 대한 레퍼런스 시간이 오래 걸리지 않습니다.
ObjectPool<T>.Clear
를 사용하여 레벨 사이의 비활성 인스턴스를 모두 파괴합니다.

컬렉션 타입 풀링 및 재사용

Lists 및 Dictionary와 같이
System.Collection
네임스페이스의 컬렉션 오브젝트를 풀링하고 재사용할 수도 있습니다.
컬렉션 클래스는 컬렉션의 값을 제거하지만 컬렉션에 할당된 메모리를 해제하지 않는
Clear
메서드를 노출합니다. 복잡한 계산을 위한 임시 헬퍼 Collections 할당하려는 경우에 유용합니다.
다음 예제 코드는 프레임당 한 번의
nearestNeighbors
List
를 할당하여 데이터 포인트 집합을 수집합니다. 이는 비효율적인 부적절한 방법입니다.
// Bad C# script example. This Update method allocates a new `List` every frame.void Update() { List<float> nearestNeighbors = new List<float>(); findDistancesToNearestNeighbors(nearestNeighbors); nearestNeighbors.Sort(); // … use the sorted list somehow …}
대신 이
List
를 메서드에서 포함 클래스에 추가하고 매번 지우고 재사용하면 코드가 프레임마다 새
List
를 할당할 필요가 없습니다.
// Good C# script example. This method re-uses the same List every frame.List<float> m_NearestNeighbors = new List<float>();void Update() { m_NearestNeighbors.Clear(); findDistancesToNearestNeighbors(NearestNeighbors); m_NearestNeighbors.Sort(); // … use the sorted list somehow …}
이 예제 코드는 여러 프레임에서
List
인스턴스 메모리를 유지하고 재사용합니다. 코드는
List
를 확장해야 할 때만 새 메모리를 할당합니다.
UnityEngine.Pool
네임스페이스는
List<T>
,
HashSet<T>
,
Dictionary<TKey, TValue>
등 여러 컬렉션 유형에 대한 준비된 풀 구현도 제공합니다.
ObjectPool<T>
와 동일한 원칙으로 작동하므로 필요에 따라 풀링된 컬렉션 오브젝트 인스턴스를 가져오고 릴리스할 수 있습니다. 자세한 내용과 예제는 동일한 네임스페이스의
CollectionPool<T>
및 기타 컬렉션 타입별 풀 클래스에 대한 API 레퍼런스 문서를 참조하십시오.

추가 리소스