AGENT SKILL
15-common-effect-manager
暂无简介
- License 许可
- MIT
- 最近更新
- 2026-04-12
- Stars
- ★ 0
- Forks
- 0
02 资源文件 4
- 参考文档evals/evals.json2.7 KB
- 参考文档README.md1.1 KB
- 参考文档SOURCE.md336 B
- 参考文档TRUST.auto.yaml2.1 KB
03 SKILL.md 正文
15-common-effect-manager
Status: ACTIVE AppliesTo: v10 Type: Component Specification
1. 목적
Unity에서 사용할 Common Effect 시스템을 정의한다.
- 스폰/디스폰은
BundlePool기반 (Addressables 캐시에서 prefab 조회) - 효과 구현은 prefab 내부 컴포넌트(ICommonEffectPlayer)로 확장
- CommonEffectObject는 상태(Play/Pause/Resume/Stop/Remove) 및 자동 반환을 관리
2. 네임스페이스
모든 코드는 namespace Devian 고정.
3. 생성 대상 패키지
com.devian.foundation(CommonPackage sample)
3.1 UPM 종속성
com.devian.foundation의 CommonPackage 샘플은 foundation Runtime에 의존한다.- 이유:
BundlePool,AssetManager,AutoSingleton등 foundation Unity runtime에 의존한다.
4. 파일 위치 (정본)
com.devian.foundation/Samples~/CommonPackage/Runtime/CommonEffect/
├── COMMON_EFFECT_ID.cs
├── CommonEffectManager.cs
├── CommonEffectObject.cs
├── ICommonEffectPlayer.cs
└── Players/
├── ParticleEffectPlayer.cs
└── AnimEffectPlayer.cs
Editor:
com.devian.foundation/Samples~/CommonPackage/Editor/Generated/
└── COMMON_EFFECT_ID.Editor.cs
5. COMMON_EFFECT_ID 규약
- string wrapper 타입
Value필드 +IsValid제공- implicit operator string / COMMON_EFFECT_ID 제공
- GroupKey =
COMMON_EFFECT
6. CommonEffectManager 규약
- Singleton은
AutoSingleton<CommonEffectManager>사용 (script-created only) - 외부 API는
CreateEffect(..., attachType, parent = null)/Remove(...)제공 - Pooling은 내부적으로
BundlePool.Spawn<CommonEffectObject>(effectId.Value, ...)/BundlePool.Despawn(effectObject)사용
Attach 타입:
public enum COMMON_EFFECT_ATTACH_TYPE
{
World,
Ground,
Child,
}
Ground 규칙:
- effect.position + (0,100,0)에서 아래로 SphereCast(radius=0.01)로 지면을 찾으면 hit.point로 이동
- parent는 전달된
parent를 그대로 사용 parent == null이면 unparented 상태 유지
World 규칙:
- parent는 전달된
parent를 그대로 사용 parent == null이면 unparented 상태 유지
Child 규칙:
parent가 명시되면 그 값을 사용parent == null이면 attachTr를 parent로 사용
7. CommonEffectObject 규약
- MonoBehaviour, IPoolable<CommonEffectObject> 구현
- 상태 머신: Playing / Paused / Stopped / Removed
- 공통 API: Init(), Play(), Pause(), Resume(), Stop(), Remove(), Clear()
- SetSortingOrder(int) / SetDirection(bool) 제공
Remove 규칙:
BundlePool.Despawn(this)로 반환
8. ICommonEffectPlayer 규약
CommonEffectObject 내부에서만 호출하는 public API이므로 메서드명은 _ prefix를 사용한다.
필수 메서드:
_OnEffectAwake(CommonEffectObject owner)_OnEffectPlay()_OnEffectPause()_OnEffectResume()_OnEffectStop()_OnEffectLateUpdate()_OnEffectClear()_SetSortingOrder(int order)(optional 구현 가능)
9. 제공 Player 2종
ParticleEffectPlayer
- 자식 ParticleSystem 전부를 관리
- playTime > 0이면 시간 종료 후 Stop
- playTime == 0이면 모든 파티클이 죽으면 Stop
- Stop 시 StopEmitting 후 fadeOutTime 대기 후 Remove
AnimEffectPlayer
[RequireComponent(typeof(AnimSequencePlayer))]로 AnimSequencePlayer 의존성 강제- Player 자체는 AnimSequenceData나 AnimationClip을 보유하지 않음
- AnimSequencePlayer.PlayDefault()만 호출하여 재생
- playSpeed 필드: PlayDefault(playSpeed, callback)으로 전달
- ComputedPlayTime 제공 (초 단위):
- AnimSequencePlayer._GetDefaultPlayTime(playSpeed) 호출
- 무한이면 -1
- clip/sequence가 없으면 0
- clip/sequence가 있으면 계산값
- 자동 제거 정책:
- ComputedPlayTime == -1이면 자동 Remove 하지 않음
- 그 외에는 시퀀스 완료 콜백으로 Remove
- Stop은 즉시 Remove
10. Hard Rules
- Spawn/Despawn은 BundlePool로만 한다.
- ID는 prefab.name 그대로 사용한다.
- 네임스페이스/폴더 규약 위반 금지.