24강. 최종 실습: 2D 택배 분류 게임

?1. 이번 강의에서 해결할 문제

각 기능은 따로 동작하지만 택배 생성부터 분류, 점수·목숨, 게임 오버와 결과 화면까지 하나의 플레이 흐름으로 연결하고 경계 상황을 검증해야 합니다.

✓2. 학습 목표

✓이 강의를 마치면

• 두 종류 이상의 택배를 최대 3회 연속 제한으로 생성합니다.
• Trigger 결과를 GameSession 이벤트와 HUD에 연결합니다.
• Coroutine, Object Pool, ScriptableObject의 선택 근거를 설명합니다.
• 정상·실패·빠른 생성·잘못된 설정을 포함한 테스트를 완료합니다.

◇3. 핵심 개념

최종 구조는 한 거대한 GameManager가 아니라 다음 흐름으로 연결됩니다.

PackageSpawner --Get--> PackagePool --Activate--> PackageItem
      │                                           │
      └─ PackageTypeSelector                      └─ Trigger 도착
                                                       │
SortZone / MissZone ──결과 요청──> GameSession ──event──> HUD / Feedback / SceneFlow

• Inspector: Prefab, 데이터 에셋, Zone 위치, 기본 수치 연결
• C#: 생성 제한, 이동, 판정, 점수·목숨과 상태 전환
• 이벤트: GameSession과 UI·피드백의 결합 제거
• 멀티플레이, 서버 저장, 광고 SDK는 이 과정 범위 밖입니다.

✎4. 단계별 실습

4-1. 최종 폴더와 Scene 구성

Assets/DeliverySorter/
├─ Data/PackageTypes/{Blue,Orange}.asset
├─ Prefabs/Package.prefab
├─ Scenes/{Game,Result}.unity
└─ Scripts/
   ├─ Data/PackageTypeData.cs
   ├─ Packages/{PackageItem,PackageMotor2D}.cs
   ├─ Spawning/{PackagePool,PackageSpawner,PackageTypeSelector}.cs
   ├─ Zones/{SortZone,MissZone}.cs
   ├─ Game/{GameSession,SceneFlow}.cs
   ├─ UI/HUDPresenter.cs
   └─ Feedback/SortFeedback.cs

Unity Editor·Inspector 작업

1. Package Prefab에 SpriteRenderer, Rigidbody2D, BoxCollider2D, PackageItem과 PackageMotor2D를 둡니다.
2. Rigidbody2D는 Dynamic, Gravity Scale 0, Freeze Rotation Z로 설정합니다.
3. BlueZone·OrangeZone·MissZone의 Collider2D는 Is Trigger로 둡니다.
4. PackagePool에 Prefab, PackageSpawner에 Pool·SpawnPoint·두 데이터 에셋을 연결합니다.
5. GameSession과 HUDPresenter, SortFeedback 참조를 연결합니다.

4-2. 최종 분류와 놓침 판정

C# · 파일 경로: Assets/DeliverySorter/Scripts/Zones/SortZone.cs

SortZone.cs

using UnityEngine;

public sealed class SortZone : MonoBehaviour
{
    [SerializeField] private PackageTypeData acceptedType;
    [SerializeField] private GameSession session;

    private void Awake()
    {
        if (acceptedType == null || session == null)
            Debug.LogError("SortZone reference is missing.", this);
    }

    private void OnTriggerEnter2D(Collider2D other)
    {
        if (!other.TryGetComponent(out PackageItem package)) return;
        if (package.IsResolved || package.Type == null) return;

        session.RegisterSort(package.Type, acceptedType);
        package.ResolveAndRelease();
    }
}

C# · 파일 경로: Assets/DeliverySorter/Scripts/Zones/MissZone.cs

MissZone.cs

using UnityEngine;

public sealed class MissZone : MonoBehaviour
{
    [SerializeField] private GameSession session;

    private void OnTriggerEnter2D(Collider2D other)
    {
        if (!other.TryGetComponent(out PackageItem package)) return;
        if (package.IsResolved) return;
        session.RegisterFailure();
        package.ResolveAndRelease();
    }
}

4-3. 최종 생성 루프

C# · 파일 경로: Assets/DeliverySorter/Scripts/Spawning/PackageSpawner.cs

PackageSpawner.cs

using System.Collections;
using UnityEngine;

public sealed class PackageSpawner : MonoBehaviour
{
    [SerializeField] private PackagePool pool;
    [SerializeField] private Transform spawnPoint;
    [SerializeField] private PackageTypeSelector selector;
    [SerializeField, Min(0.1f)] private float startInterval = 1.5f;
    [SerializeField, Min(0.1f)] private float minInterval = 0.45f;

    private Coroutine routine;
    private float startedAt;

    public void StartRun()
    {
        if (routine != null) return;
        startedAt = Time.time;
        routine = StartCoroutine(SpawnLoop());
    }

    public void StopRun()
    {
        if (routine == null) return;
        StopCoroutine(routine);
        routine = null;
    }

    private IEnumerator SpawnLoop()
    {
        while (true)
        {
            PackageTypeData type = selector.Next();
            if (type != null) pool.Get(type, spawnPoint.position);

            float minutes = (Time.time - startedAt) / 60f;
            float interval = Mathf.Max(minInterval, startInterval - minutes * 0.2f);
            yield return new WaitForSeconds(interval);
        }
    }
}

StateChanged를 구독하는 Binder가 Playing에서 StartRun, Paused·GameOver에서 StopRun을 호출합니다. GameOver에서는 입력도 비활성화하고 최고 점수를 저장한 뒤 결과 화면 버튼을 제공합니다.

4-4. 실행

PowerShell · 실행 위치: DeliverySorter2D 프로젝트 루트

Get-ChildItem .\Assets\DeliverySorter\Scripts -Recurse -Filter *.cs
Get-Content .\ProjectSettings\ProjectVersion.txt

Unity Editor에서 Console을 비우고 Game Scene을 Play합니다. C# 컴파일과 실제 Play Mode 검증은 반드시 에디터에서 수행합니다.

→5. 코드가 동작하는 이유

Spawner는 Coroutine으로 생성 시점만 관리하고 selector가 실제 타입을 결정해 같은 종류가 최대 세 번까지만 이어집니다. Pool은 인스턴스를 재사용하고 PackageItem은 한 번만 해결됩니다. Zone은 결과만 GameSession에 전달하며, GameSession 이벤트를 HUD와 피드백이 구독하므로 UI가 점수 규칙에 섞이지 않습니다.

구조 선택 근거

구조	선택 이유
Update·FixedUpdate	입력은 프레임, Rigidbody2D 이동은 물리 주기마다 필요
Coroutine	생성 간격과 난이도 대기를 순서대로 표현
Object Pool	빠르게 반복되는 택배 생성·제거 비용과 GC 할당 완화
ScriptableObject	타입별 색상·점수를 Prefab 복제 없이 공유
event	게임 규칙이 HUD와 사운드의 구체 구현을 모르게 함

!6. 자주 하는 실수와 해결법

!자주 하는 실수

• Inspector 필드 하나를 비우고 null 발생: 각 시스템 Awake에서 필수 참조를 구체적인 이름으로 검증합니다.
• GameOver 뒤 생성·입력 계속: StateChanged에서 Spawner와 입력을 함께 중단합니다.
• 두 Zone이 같은 택배 처리: IsResolved로 첫 결과만 허용합니다.
• Pool 재사용 택배가 이전 색·상태 유지: Activate에서 모든 런타임 상태를 초기화합니다.
• 모든 기능을 GameManager에 합침: 생성, 세션, UI, 저장과 피드백 클래스를 유지합니다.
• Update에서 Find 반복: Inspector 참조, 캐시와 생성 시 전달을 사용합니다.

✎7. 직접 실습

✎최종 테스트 체크리스트

• 일반 플레이: 두 종류가 생성되고 올바른 Zone에서 점수가 오른다.
• 오분류: 잘못된 Zone에서 목숨이 정확히 한 번 줄어든다.
• 놓침: 어느 Zone에도 들어가지 않은 택배가 MissZone에서 처리된다.
• 택배가 없는 상황: Scene 시작 직후 오류 없이 다음 생성을 기다린다.
• 목숨 0: GameOver UI가 보이고 입력과 추가 생성이 막힌다.
• 빠른 생성: 최소 간격에서도 Pool이 재사용되고 중복 점수가 없다.
• 연속 제한: 같은 PackageTypeData가 네 번 연속 생성되지 않는다.
• Inspector 오류: Pool Prefab, Session 또는 TMP 참조를 비우면 구체적인 오류가 나온다.
• 결과 화면: 현재·최고 점수가 표시되고 재시작하면 새 점수와 목숨으로 시작한다.

Docs/FinalArchitecture.md에 Update, Coroutine, Pool과 ScriptableObject를 선택한 이유를 각각 한 문장으로 작성하세요.

다음 단계 확장 아이디어

• 모바일 입력: 공식 Input System의 Touch Action, UI 위 터치 차단, 진동 피드백
• 성능 최적화: Sprite Atlas, 기기 Profiler, 해상도·프레임 목표별 품질 설정
• 광고: 게임 규칙과 SDK Adapter 분리, 테스트 광고 ID, 개인정보·스토어 정책 확인
• 출시: Android Build Profile, 서명 키 안전 보관, 실제 기기 테스트와 스토어 체크리스트

Android SDK·NDK·JDK, 빌드 화면과 스토어 요구 사항은 Unity 버전과 시점에 따라 달라집니다. 구현 전에 Unity 6 Android 빌드 문서와 대상 스토어 공식 정책을 확인하세요.

?8. 이해 점검 질문 3개

?이해 점검

1. PackageSpawner가 점수와 HUD를 직접 참조하지 않아도 되는 이유는 무엇인가요?
2. 같은 택배가 두 Trigger에 들어갈 때 중복 결과를 막는 상태는 무엇인가요?
3. Coroutine, Object Pool과 ScriptableObject는 각각 어떤 문제를 해결하나요?

■9. 핵심 요약

■핵심 요약

택배 생성·이동·판정, 점수·목숨·상태, UI·피드백과 저장을 작은 책임으로 연결해 2D 택배 분류 게임을 완성했습니다. 다음 과정에서는 모바일 입력과 실제 기기 최적화, 안전한 SDK 경계와 출시 절차로 확장할 수 있습니다.