AGENT SKILL

10-loading-canvas

暂无简介

使用场景视觉设计
License 许可
MIT
所属仓库
devwinsoft/devian
最近更新
2026-04-12
Stars
★ 0
Forks
0

03 SKILL.md 正文

10-loading-canvas — UILoadingCanvas

Status: ACTIVE AppliesTo: v11

Purpose

UILoadingCanvas는 loading system의 단일 public entrypoint다. Spinner, BundleLoading, SceneLoading 3개 panel의 표시 상태와 우선순위를 관리한다. bootstrap은 MobileApplication.onBootAsync()에서 UISettings.LoadingCanvasId와 UISettings.GetResourcesSearchDir("UI_LOADING_CANVAS_ID")를 읽어 수행한다.

Code Path

framework-cs/apps/UnityExample/Assets/Samples/Devian Foundation/0.1.0/UIPackage/Runtime/Loading/UILoadingCanvas.cs

Bootstrap:

framework-cs/apps/UnityExample/Assets/Samples/Devian Foundation/0.1.0/MobilePackage/Runtime/Application/MobileApplication.cs

Settings:

framework-cs/apps/UnityExample/Assets/Samples/Devian Foundation/0.1.0/UIPackage/Runtime/Base/UISettings.cs

Prefab:

framework-cs/apps/UnityExample/Assets/Resources/UI/Prefabs/uiloading_canvas.prefab

Public API

public sealed class UILoadingCanvas : UIBaseCanvas<UILoadingCanvas>
{
    public void ShowSpinner();
    public void HideSpinner();

    public void ShowBundleLoading();
    public void HideBundleLoading();
    public void SetBundleLoadingProgress(float progress);

    public void ShowSceneLoading();
    public void HideSceneLoading();
}

Runtime Rules

  • loading public API는 UILoadingCanvas.Instance만 사용한다.
  • ShowSpinner()/HideSpinner(), ShowBundleLoading()/HideBundleLoading(), ShowSceneLoading()/HideSceneLoading()는 내부 count를 증가/감소시킨다.
  • 내부 count는 spinnerCount, bundleCount, sceneCount 3개다.
  • count는 0 미만으로 내려가지 않게 막는다.
  • 실제 표시 panel은 항상 하나만 유지한다.
  • panel 우선순위는 SceneLoading > BundleLoading > Spinner로 고정한다.
  • uiloading_canvas.prefab이 panel view의 단일 source다.
  • panel view는 코드에서 생성하지 않고 prefab serialized reference를 사용한다.
  • UISpinnerLoadingPanel은 dim, spinner 참조를 prefab에서 받는다.
  • UIBundleLoadingPanel은 panel background, _progressText, _progressFill을 prefab에서 받는다.
  • UISceneLoadingPanel은 panel background를 prefab에서 받는다.
  • ShowBundleLoading() 시 progress는 0으로 초기화한다.
  • HideBundleLoading()으로 완전히 종료되면 progress를 초기화한다.
  • 외부 progress 세팅은 SetBundleLoadingProgress(float)만 허용한다.

Bootstrap Flow

MobileApplication.onBootAsync()
  → Resources.Load<UISettings>(UISettings.ResourcesPath)
  → settings.LoadingCanvasId 확인
  → settings.GetResourcesSearchDir("UI_LOADING_CANVAS_ID")
  → resourcePath = searchDir + "/" + settings.LoadingCanvasId.Value
  → Resources.Load<GameObject>(resourcePath)
  → Instantiate
  → DontDestroyOnLoad
  → UILoadingCanvas.Init()

References

  • Overview: ../00-overview/SKILL.md
  • UISettings: ../../10-base-system/13-ui-settings/SKILL.md
  • UIBaseCanvas: ../../10-base-system/11-ui-canvas-system/SKILL.md

04 同仓库更多 Skills