🫧Art_009 Prefab Spawner

오브젝트를 무작위 위치에 생성

• 3D 공간의 일정 범위 내에서 spawn이 되고 커졌다가 작아지고 사라지는 연출
• 미리 Prefab을 만들어서 GameObject의 인스펙터 창에서 선택
• SpawnRate로 생기는 주기를 관리

적용 방법

• PrefabSpawner.cs를 씬의 빈 오브젝트에 넣고 Prefab 칸에 해당 프리팹을 할당합니다.
• 스포너 오브젝트의 위치(Transform.position)가 n x n x n 큐브의 정중앙이 됩니다.
• 지정된 영역 내에서 Prefab 오브젝트가 나타났다가 잠시 후 작아지며 사라집니다.

📄PrefabSpawner.cs

using UnityEngine;
using System.Collections;

public class PrefabSpawner : MonoBehaviour
{
  public GameObject prefab;
  public float spawnRate = 0.1f;
  public float nextSpawnTime;

  void Update()
  {
    if (Time.time > nextSpawnTime)
    {
      SpawnAndAnimate();
      nextSpawnTime = Time.time + spawnRate;
    }
  }

  void SpawnAndAnimate()
  {
    Vector3 randomPos = transform.position + new Vector3(
      Random.Range(-3f, 3f),
      Random.Range(-3f, 3f),
      Random.Range(-3f, 3f));

    GameObject newObj = Instantiate(prefab, randomPos, Quaternion.identity);

    StartCoroutine(ScaleRoutine(newObj));
  }

  IEnumerator ScaleRoutine(GameObject target)
  {
    if (target == null) yield break;

    target.transform.localScale = Vector3.zero;
    float finalScale = Random.Range(0.3f, 0.6f);
    float speed = 0.3f;

    float elapsed = 0f;
    while (elapsed < speed)
    {
      if (target == null) yield break;
      elapsed += Time.deltaTime;
      target.transform.localScale = Vector3.Lerp(
        Vector3.zero, Vector3.one * finalScale, elapsed / speed
      );
      yield return null;
    }

    yield return new WaitForSeconds(1.5f);

    elapsed = 0f;
    while (elapsed < speed)
    {
      if (target == null) yield break;
      elapsed += Time.deltaTime;
      target.transform.localScale = Vector3.Lerp(
        Vector3.one * finalScale, Vector3.zero, elapsed / speed
      );
      yield return null;
    }

    Destroy(target);
  }
}

---

📄PrefabSpawner.cs (주석)

// UnityEngine 네임스페이스를 가져옵니다. (유니티의 핵심 기능 사용 위해 필수)
using UnityEngine;
// System.Collections 네임스페이스를 가져옵니다. (코루틴 사용 위해 필수)
using System.Collections;

// MonoBehaviour 를 상속받는 'PrefabSpawner' 라는 이름의 공공 (public) 클래스를 정의합니다.
public class PrefabSpawner : MonoBehaviour
{
    // [변수 1] 인스펙터 창에서 할당할 수 있는 생성할 프리팹 (객체) 입니다.
    public GameObject prefab;
    
    // [변수 2] 객체가 생성되는 시간 간격 (초) 입니다. 값이 작을수록 많이 생성됩니다.
    public float spawnRate = 0.1f;
    
    // [변수 3] 다음으로 객체가 생성될 예정인 시점 (게임 시작 후 경과 시간) 을 저장합니다.
    public float nextSpawnTime;

    // Update 는 매 프레임 (화면이 갱신될 때마다) 자동으로 호출되는 함수입니다.
    void Update()
    {
        // 현재 게임 시간 (Time.time) 이 다음 생성 시간 (nextSpawnTime) 보다 지났는지 확인합니다.
        if (Time.time > nextSpawnTime)
        {
            // 객체 생성 및 애니메이션 실행 함수를 호출합니다.
            SpawnAndAnimate();
            
            // 다음 생성 시간을 '현재 시간 + 생성 간격'으로 갱신하여 타이밍을 조절합니다.
            nextSpawnTime = Time.time + spawnRate;
        }
    }

    // 객체를 생성하고 애니메이션 코루틴을 시작하는 일반 함수입니다.
    void SpawnAndAnimate()
    {
        // [위치 계산] 현재 객체 (이 스크립트가 붙은 것) 의 위치를 기준으로 무작위 오프셋을 더합니다.
        // Random.Range(-3f, 3f) 는 -3 에서 3 사이의 랜덤한 값을 의미합니다. (X, Y, Z 축 모두)
        Vector3 randomPos = transform.position + new Vector3(
            Random.Range(-3f, 3f),   // X 축 무작위 위치 (-3 ~ 3)
            Random.Range(-3f, 3f),   // Y 축 무작위 위치 (-3 ~ 3)
            Random.Range(-3f, 3f));  // Z 축 무작위 위치 (-3 ~ 3)

        // [객체 생성] 지정한 프리팹을 계산된 위치 (randomPos), 회전 없음 (Quaternion.identity) 으로 생성합니다.
        // 생성된 객체의 참조값을 newObj 변수에 저장합니다.
        GameObject newObj = Instantiate(prefab, randomPos, Quaternion.identity);

        // [코루틴 시작] 생성된 객체 (newObj) 를 대상으로 크기 조절 애니메이션 코루틴을 시작합니다.
        StartCoroutine(ScaleRoutine(newObj));
    }

    // IEnumerator 를 반환하는 함수는 '코루틴 (Coroutine)'이 됩니다. (비동기적 처리 가능)
    IEnumerator ScaleRoutine(GameObject target)
    {
        // [안전장치] 대상 객체가 이미 삭제되었다면 코루틴을 즉시 종료합니다. (에러 방지)
        if (target == null) yield break;

        // 애니메이션 시작 전, 객체의 크기를 0 (Vector3.zero) 으로 초기화합니다.
        target.transform.localScale = Vector3.zero;
        
        // [변수] 최종적으로 커질 크기를 0.3 에서 0.6 사이 랜덤 값으로 결정합니다.
        float finalScale = Random.Range(0.3f, 0.6f);
        
        // [변수] 크기가 변하는 데 걸릴 시간 (속도) 을 0.3 초로 설정합니다.
        float speed = 0.3f;

        // [타이머] 경과 시간을 저장할 변수를 0 으로 초기화합니다.
        float elapsed = 0f;
        
        // 경과 시간이 설정된 속도 (speed) 보다 작을 동안 반복합니다. (커지는 애니메이션 루프)
        while (elapsed < speed)
        {
            // [안전장치] 루프 도중 객체가 삭제되면 코루틴을 종료합니다.
            if (target == null) yield break;
            
            // 경과 시간에 현재 프레임의 시간 차이 (Time.deltaTime) 를 더합니다.
            elapsed += Time.deltaTime;
            
            // [보간] 현재 크기를 0 에서 최종 크기 (finalScale) 까지 부드럽게 변경합니다.
            // elapsed / speed 는 0.0 에서 1.0 까지의 비율을 의미합니다.
            target.transform.localScale = Vector3.Lerp(
                Vector3.zero,                  // 시작 크기 (0)
                Vector3.one * finalScale,      // 목표 크기 (랜덤 값)
                elapsed / speed                // 진행 비율 (0~1)
            );
            
            // [대기] 다음 프레임이 될 때까지 코루틴 실행을 잠시 멈춥니다. (부드러운 애니메이션 위해 필수)
            yield return null;
        }

        // [대기] 다 커진 상태에서 1.5 초 동안 기다립니다.
        yield return new WaitForSeconds(1.5f);

        // [타이머 초기화] 사라지는 애니메이션을 위해 경과 시간을 다시 0 으로 만듭니다.
        elapsed = 0f;
        
        // 경과 시간이 속도보다 작을 동안 반복합니다. (작아지는 애니메이션 루프)
        while (elapsed < speed)
        {
            // [안전장치] 루프 도중 객체가 삭제되면 코루틴을 종료합니다.
            if (target == null) yield break;
            
            // 경과 시간을 업데이트합니다.
            elapsed += Time.deltaTime;
            
            // [보간] 현재 크기를 최종 크기에서 0 으로 부드럽게 변경합니다. (반대 방향)
            target.transform.localScale = Vector3.Lerp(
                Vector3.one * finalScale,      // 시작 크기 (랜덤 값)
                Vector3.zero,                  // 목표 크기 (0)
                elapsed / speed                // 진행 비율 (0~1)
            );
            
            // [대기] 다음 프레임까지 대기합니다.
            yield return null;
        }

        // [객체 삭제] 애니메이션이 모두 끝나면 메모리에서 객체를 완전히 삭제합니다.
        Destroy(target);
    }
}

---

코드 설명

1. 기능별 구획 설명

이 스크립트는 크게 3 가지 주요 기능으로 나뉩니다.

1. 스폰 타이밍 관리 (Update 함수)

• 게임이 실행되는 동안 매 프레임 시간을 체크합니다.
• spawnRate 에 설정된 시간 간격마다 생성 로직을 트리거합니다.
• 프레임 속도에 상관없이 일정한 시간 간격을 유지하기 위해 Time.time 을 사용합니다.

2. 객체 생성 및 위치 지정 (SpawnAndAnimate 함수)

• 스크립트가 붙어있는 객체 (transform.position) 를 중심으로 ±n 유닛 범위 내의 무작위 3 차원 좌표를 계산합니다.
• Instantiate 를 통해 프리팹을 실제 씬 (Scene) 에 나타냅니다.
• 생성과 동시에 애니메이션 코루틴을 실행합니다.

3. 생명주기 애니메이션 (ScaleRoutine 코루틴)

• 탄생: 크기가 0 에서 랜덤한 크기까지 서서히 커집니다 (Lerp 사용).
• 유지: 다 커진 상태로 1.5 초간 정지합니다.
• 소멸: 크기가 다시 0 으로 서서히 줄어들며 사라집니다.
• 정리: Destroy 로 객체를 메모리에서 제거하여 성능 저하를 막습니다.

2. 변수 의미 및 문법 설명

주요 변수 (Variables)

변수명	타입	의미
prefab	GameObject	씬에 생성될 원본 객체입니다. 인스펙터에서 드래그하여 할당해야 합니다.
spawnRate	float	객체 생성 간격 (초) 입니다. 예: 0.1 이면 0.1 초마다 생성 시도.
nextSpawnTime	float	다음 생성이 허용되는 시점의 게임 시간입니다.
randomPos	Vector3	객체가 생성될 무작위 3 차원 좌표입니다.
newObj / target	GameObject	생성된 객체 또는 애니메이션의 대상이 되는 객체의 참조값입니다.
finalScale	float	객체가 최대로 커질 때의 크기 배율입니다.
elapsed	float	애니메이션이 시작된 후 경과한 시간입니다.

주요 문법 및 유니티 API (Syntax & API)

1.IEnumerator 와 yield return (코루틴)

• 의미: 함수의 실행을 잠시 멈췄다가 나중에 다시 이어서 실행할 수 있게 해주는 기능입니다.
• 용도: WaitForSeconds 처럼 시간을 기다리거나, yield return null 처럼 다음 프레임까지 기다릴 때 사용합니다. 일반 함수에서는 Wait 하면 게임이 멈추지만, 코루틴은 게임 흐름을 끊지 않고 대기합니다.
• yield break: 코루틴을 중간에 강제로 종료할 때 사용합니다. (여기서는 객체가 미리 삭제되었을 때 에러를 방지하기 위해 사용)

2. Vector3.Lerp(A, B, t) (선형 보간)

의미: 값 A 에서 값 B 까지 t 비율만큼 부드럽게 이동한 값을 반환합니다.
문법: t 는 보통 0.0 ~ 1.0 사이의 값입니다. 0 이면 A, 1 이면 B, 0.5 이면 중간 값이 됩니다.
용도: 프레임마다 t 값을 조금씩 증가시켜주면 부드러운 애니메이션 (부드러운 크기 조절) 이 됩니다.

3. Instantiate 와 Destroy

• Instantiate: 코드상으로 객체를 복제하여 씬에 생성합니다.
• Destroy: 객체를 씬에서 제거하고 메모리를 해제합니다. 제너레이티브 아트처럼 객체가 계속 생겨나고 사라지는 경우, Destroy 를 하지 않으면 메모리 누수로 게임이 느려집니다.

4. Random.Range(min, max)

• 의미: 최소값 (min) 과 최대값 (max) 사이의 랜덤한 값을 반환합니다.
• 주의: 정수 (int) 와 실수 (float) 에 따라 동작 범위가 약간 다를 수 있으나, 여기서는 3f 처럼 실수를 사용했으므로 최대값 (3.0) 도 포함될 수 있는 범위로 작동합니다.

5. Quaternion.identity

• 의미: 회전이 전혀 없는 상태 (0, 0, 0) 를 나타냅니다.
• 용도: 객체를 생성할 때 회전값을 기본값으로 유지하고 싶을 때 사용합니다.

3. 팁 (Tip)

• 인스펙터 설정: 이 스크립트를 씬의 빈 객체 (Empty GameObject) 에 붙인 후, 인스펙터 창에서 Prefab 항목에 생성하고 싶은 3D 객체 (예: 구, 큐브 등) 를 드래그해야 작동합니다.
• 성능 최적화: spawnRate 를 너무 작게 (예: 0.001) 설정하면 순식간에 수천 개의 객체가 생성되어 컴퓨터가 멈출 수 있으니 주의하세요.
• 안전장치 if (target == null) : 코루틴이 실행되는 도중에 외부 요인 (다른 스크립트 등) 으로 객체가 삭제될 수 있습니다. 이때 target 에 접근하면 에러가 나므로, 매 루프마다 객체가 존재하는지 확인하는 것이 좋은 코딩 습관입니다.