AGENT SKILL

00-overview

暂无简介

License 许可
MIT
所属仓库
devwinsoft/devian
最近更新
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

  • UIToastService
  • UIToastCanvas
  • UIToastPanel
  • UIToastGroup
  • UIToastFrame
  • group별 queue / duplicate / max-visible 정책
  • UIToastService.Initialize() 기반 toast canvas bootstrap
  • UISettings.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

04 同仓库更多 Skills