AGENT SKILL
00-overview
暂无简介
- License 许可
- MIT
- 最近更新
- 2026-04-12
- Stars
- ★ 0
- Forks
- 0
03 SKILL.md 正文
13-ui-toast-system — Overview
Status: ACTIVE AppliesTo: v11
Overlay 기반 non-blocking toast system.
canvas bootstrap과 전역 settings는 UIToastService가 담당하고,
런타임 표시/queue/duplicate 처리는 UIToastService → UIToastPanel → UIToastGroup → UIToastFrame 계층이 담당한다.
canvas ID, frame prefab 참조, group 설정은 모두 UISettings.asset에서 공급한다.
Start Here
| Document | Description |
|---|---|
| 01-policy | Canvas Ownership / Text Boundary / Non-Blocking / Tween Boundary / Pool Cleanup |
| 10-service | UIToastService — 외부 진입점, Show API |
| 11-canvas-panel | UIToastCanvas + UIToastPanel — canvas 계층 및 group 초기화 |
| 12-group | UIToastGroup — queue / duplicate / max-visible / layout |
| 13-frame | UIToastFrame — pool / tween / lifetime |
| 14-data-model | ToastGroupConfig / Enums / UIToastDefaults |
| 15-ui-toast-frame-id | UI_TOAST_FRAME_ID — UIToastFrame 프리팹 참조 ID (AssetId 패턴) |
| 16-ui-toast-canvas-id | UI_TOAST_CANVAS_ID — UIToastCanvas 프리팹 참조 ID (AssetId 패턴) |
| 13-ui-settings | UISettings — Resources 기반 전역 Toast/Popup 통합 설정 asset |
Scope
Includes
UIToastServiceUIToastCanvasUIToastPanelUIToastGroupUIToastFrame- group별 queue / duplicate / max-visible 정책
UIToastService.Initialize()기반 toast canvas bootstrapUISettings.asset기반 전역 group 설정
Excludes
- popup / blocker / dim
TEXT_ID직접 처리- interaction / click
- business logic
Code Path
framework-cs/upm/com.devian.foundation/Samples~/UIPackage/Runtime/Toast/
├── UIToastService.cs
├── UIToastCanvas.cs
├── UIToastPanel.cs
├── UIToastGroup.cs
├── UIToastFrame.cs
├── ToastGroupConfig.cs
├── ToastEnums.cs
├── UIToastDefaults.cs
└── UI_TOAST_FRAME_ID.cs
Bootstrap:
framework-cs/upm/com.devian.foundation/Samples~/MobilePackage/Runtime/Application/MobileApplication.cs
Runtime Flow
Bootstrap
MobileApplication.onLoadCompletedAsync()
→ UIToastService.Instance.Initialize()
→ UIToastCanvas.Instance 또는 FindAnyObjectByType 조회
→ null이면: UISettings.ToastCanvasId 읽기
→ BundlePool.Spawn<UIToastCanvas>(canvasId)
→ DontDestroyOnLoad(canvas)
→ canvas.Init()
Show
Caller
→ UIToastService.Show(...)
→ ResolvePanel() : UIToastCanvas.Instance 또는 FindAnyObjectByType
→ UIToastPanel.Enqueue(request)
→ UIToastGroup.Enqueue(request)
→ duplicate 처리 (DuplicatePolicy)
→ max-visible 미만이면 ShowImmediate
→ max-visible 초과이면 _pending queue에 적재
→ UIToastFrame.Show(duration, onHidden)
→ UIToastFrame 소유 show transition id 재생
→ CoLifetime 코루틴 시작
→ lifetime 만료
→ UIToastFrame.HideInternal()
→ UIToastFrame 소유 hide transition id 재생
→ hide tween 완료
→ UIToastGroup.OnFrameHidden()
→ BundlePool.Despawn(frame)
→ FlushQueue() → 다음 pending show
Related
- Parent:
../SKILL.md - Canvas System:
../10-base-system/11-ui-canvas-system/SKILL.md - UITweenSystem:
../22-ui-tween-system/00-overview/SKILL.md