Resource Loading and Caching

Abstract

로딩과 캐싱에서 알아야 할 것은 두 가지입니다 — 로드는 비동기다, 그리고 한 번 로드한 것은 한동안 남아 있다. 프레임워크는 캐시를 두 겹으로 둡니다. 겉은 "숨긴 인스턴스를 보관하는 풀", 속은 "프리팹 원본을 붙잡고 있는 Addressables 핸들". 이 두 겹이 언제 채워지고 언제 비워지는지를 알면 로딩 끊김과 메모리 사용을 조절할 수 있습니다.

실무에서 필요한 순간

•

첫 스폰만 끊기고 그 뒤는 매끄러운 이유가 궁금할 때

•

"적을 다 잡았는데 메모리가 안 줄어든다"는 보고를 받았을 때

•

풀 용량과 만료 시간을 얼마로 잡아야 할지 정할 때

ToyboxNightmare 에서는

엔티티 그룹 5개가 각자 인스턴스 풀을 갖고, 전부 만료 60초 · 검사 주기 60초입니다. 적과 투사체가 끊임없이 재사용되므로 전투 중에는 새 로딩이 거의 일어나지 않습니다.

로딩이 일어나는 순서를 단계별로 보려면 Resource Loading(리소스 로딩)-Addressable, 풀의 내부 규칙은 오브젝트 풀링 (Object Pooling) 을 보세요.

캐시는 두 겹이다

graph TD
    A["ShowEntity(&quot;Zombunny&quot;)"] --> B{"① 인스턴스 풀에<br>쉬고 있는 Zombunny 가 있나"}
    B -- 있다 --> Z["그 인스턴스를 꺼내 OnShow<br>(로딩 없음, 같은 프레임)"]
    B -- 없다 --> C{"② 프리팹이 이미<br>메모리에 있나"}
    C -- 있다 --> D["Instantiate<br>(로드는 즉시 끝남)"]
    C -- 없다 --> E["번들에서 프리팹 로드<br>(몇 프레임)"] --> D
    D --> Z2["OnInit → OnShow"]

Mermaid

복사

	① 인스턴스 풀	② 에셋 핸들
보관하는 것	HideEntity 된 GameObject	프리팹·클립 원본
누가 관리하나	엔티티 그룹 / UI 그룹 (프레임워크)	Addressables
아끼는 비용	Instantiate 와 OnInit	디스크 읽기
비워지는 때	만료 시간이 지나거나 용량을 넘을 때	그 에셋으로 만든 인스턴스가 모두 파괴됐을 때
설정하는 곳	Entity / UI 컴포넌트의 그룹 설정	(자동)

속 캐시(②)는 겉 캐시(①)에 매여 있습니다. 풀에 인스턴스가 하나라도 남아 있으면 프리팹도 메모리에 남습니다.

풀 설정값 읽는 법

GameFramework.prefab 의 Entity 오브젝트에서 그룹마다 네 가지를 정합니다.

필드	뜻	예제의 값
Instance Capacity	풀에 보관해 둘 최대 개수. 스폰 상한이 아니다 — 넘쳐도 스폰은 되고, 넘친 만큼만 회수될 때 보관되지 않고 파괴된다	Player 4 / Enemy 64 / Projectile 64 / Effect 32 / Ally 2
Instance Expire Time	이 시간 동안 다시 쓰이지 않은 인스턴스는 정리 대상이 된다	60초
Instance Auto Release Interval	정리 검사를 도는 주기	60초
Instance Priority	용량이 넘칠 때 낮은 것부터 버린다	0

정하는 요령

•

Capacity 는 동시 최대 등장 수보다 조금 크게. 너무 작으면 웨이브마다 Instantiate / Destroy 가 반복되어 풀링 효과가 사라진다

•

Expire Time 은 웨이브 사이 간격보다 길게. 짧으면 쉬는 동안 다 파괴되고 다음 웨이브에서 다시 만든다

•

보스전에만 나오는 것처럼 가끔 쓰는 무거운 것은 그룹을 따로 만들어 만료를 짧게 준다. 끝난 뒤 오래 붙잡고 있을 이유가 없다

메모리는 언제 줄어드나

엔티티를 숨긴 직후에는 줄지 않습니다. 인스턴스가 풀에 남고, 그래서 프리팹도 남습니다. 예제 기준으로 스폰이 멈춘 뒤 1~2분(만료 60초 + 다음 검사까지 최대 60초)이 지나야 인스턴스가 파괴되고, 마지막 인스턴스까지 사라지면 프리팹이 내려갑니다.

지금 당장 비우고 싶을 때:

// 쉬고 있는 인스턴스를 전부 정리한다 (스테이지를 떠날 때)
GameEntry.GetComponent<ObjectPoolComponent>().ReleaseAllUnused();

// 이어서, 아무도 참조하지 않게 된 에셋을 엔진이 정리하도록 예약한다
GameEntry.GetComponent<ResourceComponent>().UnloadUnusedAssets(true);

복사

확인하는 법 — 플레이 중 디버거 창을 열어 다음 탭을 봅니다.

탭	보이는 것
Profiler → Object Pool	그룹별 인스턴스 풀. 개수가 Capacity 근처에서 멈추는지, 스폰이 끝난 뒤 줄어드는지
Profiler → Memory → Summary	텍스처·메시·오디오별 메모리. 스테이지를 반복해도 계단식으로 오르지 않는지

로딩 끊김 줄이기

첫 스폰은 "프리팹 로드 + 첫 Instantiate" 가 한꺼번에 일어나 끊깁니다. 로딩 화면에서 미리 치러 두면 됩니다.

방법	미리 치르는 것	맞는 대상
ResourceComponent.LoadAsset 으로 잡아 두기	로드만	사운드 클립, ScriptableObject
한 번 ShowEntity 했다가 바로 HideEntity	로드 + 인스턴스화	적, 투사체, 이펙트

두 번째 방법으로 넣어 둔 인스턴스도 Expire Time 이 지나면 사라지므로, 쓰기 직전(스테이지 로딩 화면)에 합니다. 코드는 Resource Loading(리소스 로딩)-Addressable 의 "미리 데우기" 절에 있습니다.

자주 걸리는 곳

•

풀에서 다시 나온 인스턴스는 이전 상태 그대로입니다. 체력·위치·타이머·애니메이터를 OnShow 에서 전부 리셋해야 합니다. OnInit 은 인스턴스가 처음 만들어질 때 한 번만 불립니다.

•

재사용은 주소 단위입니다. 같은 그룹 안에서도 Zombunny 인스턴스는 Zombunny 요청에만 쓰이고 Hellephant 요청에는 쓰이지 않습니다.

•

Destroy 나 SetActive(false) 로 치우면 풀이 어긋납니다. 반드시 HideEntity(예제에서는 SafeHide())로 돌려보냅니다.

•

로드에 실패해도 예외는 나지 않습니다. 실패 이벤트만 옵니다. 잘못된 주소를 반복 요청해도 실패한 핸들은 그때그때 해제되므로 쌓이지 않습니다.