[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M6CBBWEY17WJJ2DF11SEZDTC":3,"skill-same:01M6CBBWEY17WJJ2DF11SEZDTC":44},{"skillNo":4,"name":5,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":15,"categories":16,"keywords":17,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":21,"frontMatter":22,"refName":23,"commitSha":24,"skillDirectory":25,"forksCount":13,"repositoryHtmlUrl":26,"repositoryHomepageUrl":6,"ownerHtmlUrl":27,"ownerBlogUrl":6,"ownerDescription":28,"updatedAt":29,"install":30,"resources":43},"01M6CBBWEY17WJJ2DF11SEZDTC","28-scene-trans-manager",null,"devwinsoft\u002Fdevian","devwinsoft","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F22570160?v=4","01M6C6RR8W05NH8NPKQNCE3Q72","maoshy","01M6C6RRDJ5TJJCZXRTY801YDH",0,"MIT","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian-unity\u002F20-common-package\u002F28-scene-trans-manager\u002FSKILL.md",[],[18],"28 scene trans manager","2026-11-10 10:12:30",false,"# 28-scene-trans-manager\n\nStatus: ACTIVE\nAppliesTo: v10\nType: Component\n\n## Purpose\n\nScene 전환 파이프라인을 단일화(직렬화)하고, 씬별 초기화\u002F정리를 SceneBase 훅으로 분리한다.\n\n---\n\n## Files (SSOT)\n\n- `framework-cs\u002Fupm\u002Fcom.devian.foundation\u002FSamples~\u002FCommonPackage\u002FRuntime\u002FUnity\u002FScene\u002FSceneBase.cs`\n- `framework-cs\u002Fupm\u002Fcom.devian.foundation\u002FSamples~\u002FCommonPackage\u002FRuntime\u002FUnity\u002FScene\u002FSceneTransManager.cs`\n\n---\n\n## Concepts\n\n### SceneBase\n\n씬 라이프사이클 훅을 제공하는 추상 베이스 클래스. Bootstrap과 무관한 순수 라이프사이클만 담당한다.\n씬 루트(또는 유일한 오브젝트)에 1개만 존재하는 것을 권장한다. 2개 이상이면 경고 로그를 출력하고 첫 번째만 사용한다.\n\n**라이프사이클 훅:**\n\n| 훅 | 호출 시점 | 호출 주체 | 용도 |\n|----|----------|----------|------|\n| `onInitAwake()` | Unity Awake()에서 항상 1회 | SceneBase.Awake (private) | 레퍼런스 캐싱, 초기 상태 구성, 컴포넌트 연결 등 전환과 무관한 준비 작업 |\n| `Enter()` → `onEnter()` | 씬 진입 시 (전환 또는 부팅) | SceneTransManager | 씬 진입 상태 초기화 |\n| `onStart()` | Unity Start 시점 | SceneBase.Start (private) | 씬 시작 로직 |\n| `Exit()` → `onExit()` | 전환으로 이탈 시 | SceneTransManager | 정리 작업 |\n| `onDestroy()` | Unity OnDestroy() 시점 | SceneBase.OnDestroy (private) | 오브젝트 파괴 시 정리 작업 |\n\n**Template Method 패턴:**\n- `Awake()` \u002F `Start()` \u002F `OnDestroy()` — private. Unity 콜백을 SceneBase가 소유하며 파생 클래스에서 override 불가.\n- `Enter()` \u002F `Exit()` — public 파사드. SceneTransManager가 호출한다.\n- `onEnter()` \u002F `onExit()` \u002F `onStart()` \u002F `onInitAwake()` \u002F `onDestroy()` — protected 훅. 파생 클래스가 구현한다.\n\n### SceneTransManager\n\n**CompoSingleton 기반 전역 흐름 제어자**로, Scene 전환을 직렬화(동시 전환 방지)한다.\n소비자 bootstrap prefab 또는 scene object가 인스턴스를 명시적으로 배치해야 한다.\n\n**책임:**\n- 전환 흐름 직렬화 (동시 전환 방지)\n- Fade 시간 전달 (이벤트 위임)\n- SceneBase Exit\u002FEnter 호출\n- Hook(beforeUnload\u002FafterLoad) 실행\n- Bootstrap\u002F`BootProc()` 실행은 책임 범위가 아님\n\n**전환 순서 (LoadSceneAsync):**\n1. FadeOutRequested 이벤트 발생 (fadeOutSeconds > 0인 경우)\n2. beforeUnload 훅 실행 (있으면)\n3. 현재 씬의 `SceneBase.Exit()` 호출\n4. `AssetManager.LoadSceneAsync()` 로 새 씬 로드\n5. afterLoad 훅 실행 (있으면)\n6. 새 씬의 `SceneBase.Enter()` 호출\n7. FadeInRequested 이벤트 발생 (fadeInSeconds > 0인 경우)\n\n**특징:**\n- `CompoSingleton\u003CSceneTransManager>` 상속\n- bootstrap prefab 또는 scene object에 명시적으로 배치\n- `_isTransitioning` 플래그로 중복 전환 방지\n- Delegate 기반 Hook (beforeUnload, afterLoad)\n- 페이드는 이벤트로 위임 (FadeOutRequested, FadeInRequested)\n\n### 페이드 위임 (Hard Rule)\n\n**SceneTransManager는 페이드 UI(CanvasGroup\u002FOverlay)를 직접 소유하지 않는다.**\n\n페이드 처리는 외부 컴포넌트가 이벤트를 구독하여 처리한다:\n\n```csharp\n\u002F\u002F 페이드 이벤트\npublic event Func\u003Cfloat, Task>? FadeOutRequested;\npublic event Func\u003Cfloat, Task>? FadeInRequested;\n```\n\n- 구독자는 fadeSeconds 동안 페이드를 수행하는 Task를 반환한다.\n- 여러 구독자가 있으면 등록 순서대로 순차 실행된다.\n- fadeSeconds가 0 이하면 이벤트 호출을 스킵한다.\n\n### 부팅 씬 (첫 씬) 처리\n\nSceneTransManager는 `Start()`에서 Active Scene의 SceneBase를 찾아:\n- `Enter()`를 호출한다\n- onStart는 SceneBase.Start()에서 호출된다\n\nBootstrap이 필요하면, contents\u002Fapp layer가 Scene 진입 전 별도로 `BootProc()`를 보장해야 한다.\n\n### Additive 모드\n\n- Additive 모드 로드는 가능하지만, ActiveScene 선택은 best-effort로 처리한다.\n- Single 모드면 Unity가 활성 씬을 전환하므로 자동으로 처리된다.\n\n---\n\n## API\n\n### LoadSceneAsync\n\n```csharp\npublic async Task LoadSceneAsync(\n    string sceneKey,\n    LoadSceneMode mode = LoadSceneMode.Single,\n    float fadeOutSeconds = 0.2f,\n    float fadeInSeconds = 0.2f,\n    Func\u003CTask>? beforeUnload = null,\n    Func\u003CTask>? afterLoad = null,\n    Action\u003Cstring>? onError = null)\n```\n\n| 파라미터 | 설명 | 기본값 |\n|----------|------|--------|\n| sceneKey | Addressables 씬 키 | (필수) |\n| mode | LoadSceneMode.Single 또는 Additive | Single |\n| fadeOutSeconds | 페이드 아웃 시간 (0 이하면 스킵) | 0.2f |\n| fadeInSeconds | 페이드 인 시간 (0 이하면 스킵) | 0.2f |\n| beforeUnload | 언로드 전 실행할 Task | null |\n| afterLoad | 로드 후 실행할 Task | null |\n| onError | 에러 콜백 | null |\n\n---\n\n## Error\u002FLog\n\n- 로깅은 `Devian.Log` 사용 (메시지 1개만, 필요하면 ex 문자열 포함)\n- 실패 시 `Devian.Log.Error(\"...\")`\n- SceneBase가 여러 개 발견되면 `Devian.Log.Warn(...)` 로 경고 후 첫 번째 사용\n\n---\n\n## Usage Example\n\n### 기본 사용 (LoadSceneAsync)\n\n```csharp\n\u002F\u002F 기본 전환 (페이드 0.2초)\nawait SceneTransManager.Instance.LoadSceneAsync(\"SceneKey_Main\");\n\n\u002F\u002F 페이드 시간 커스텀\nawait SceneTransManager.Instance.LoadSceneAsync(\n    \"SceneKey_Game\",\n    LoadSceneMode.Single,\n    fadeOutSeconds: 0.5f,\n    fadeInSeconds: 0.3f\n);\n```\n\n### Hook 사용 (beforeUnload\u002FafterLoad)\n\n```csharp\nawait SceneTransManager.Instance.LoadSceneAsync(\n    \"SceneKey_Game\",\n    LoadSceneMode.Single,\n    fadeOutSeconds: 0.25f,\n    fadeInSeconds: 0.25f,\n    beforeUnload: () => SaveBeforeLeaveAsync(),\n    afterLoad: () => WarmupAfterEnterAsync()\n);\n\nasync Task SaveBeforeLeaveAsync()\n{\n    \u002F\u002F 씬 떠나기 전 저장 로직\n    await Task.CompletedTask;\n}\n\nasync Task WarmupAfterEnterAsync()\n{\n    \u002F\u002F 씬 로드 후 워밍업 로직\n    await Task.CompletedTask;\n}\n```\n\n### 페이드 위임 (외부 컴포넌트가 구독)\n\n```csharp\n\u002F\u002F 페이드 UI 컴포넌트에서 구독\nvoid OnEnable()\n{\n    SceneTransManager.Instance.FadeOutRequested += OnFadeOut;\n    SceneTransManager.Instance.FadeInRequested += OnFadeIn;\n}\n\nvoid OnDisable()\n{\n    if (Singleton.TryGet\u003CSceneTransManager>(out var stm))\n    {\n        SceneTransManager.Instance.FadeOutRequested -= OnFadeOut;\n        SceneTransManager.Instance.FadeInRequested -= OnFadeIn;\n    }\n}\n\nasync Task OnFadeOut(float seconds)\n{\n    \u002F\u002F CanvasGroup alpha를 0 → 1로 변경\n    float t = 0f;\n    while (t \u003C seconds)\n    {\n        t += Time.unscaledDeltaTime;\n        _canvasGroup.alpha = Mathf.Clamp01(t \u002F seconds);\n        await Task.Yield();\n    }\n    _canvasGroup.alpha = 1f;\n}\n\nasync Task OnFadeIn(float seconds)\n{\n    \u002F\u002F CanvasGroup alpha를 1 → 0로 변경\n    float t = 0f;\n    while (t \u003C seconds)\n    {\n        t += Time.unscaledDeltaTime;\n        _canvasGroup.alpha = 1f - Mathf.Clamp01(t \u002F seconds);\n        await Task.Yield();\n    }\n    _canvasGroup.alpha = 0f;\n}\n```\n\n### SceneBase 구현 예시\n\nBootstrap 통합이 필요하면 contents 레이어에서 SceneBase를 상속하여 직접 구현한다 (프레임워크는 SceneBoot을 제공하지 않는다).\n\n```csharp\npublic class MainScene : SceneBase\n{\n    \u002F\u002F 전환과 무관하게 항상 1회 호출 (Unity Awake 시점)\n    protected override void onInitAwake()\n    {\n        \u002F\u002F 레퍼런스 캐싱, 컴포넌트 연결 등\n    }\n\n    \u002F\u002F 씬 진입 시 호출 (SceneTransManager가 Enter() 호출)\n    protected override async Task onEnter()\n    {\n        \u002F\u002F 씬 진입 시 초기화 로직\n        await Task.CompletedTask;\n    }\n\n    \u002F\u002F Unity Start 시점에 호출 (SceneBase.Start()가 호출)\n    protected override async Task onStart()\n    {\n        \u002F\u002F 씬 시작 로직\n        await Task.CompletedTask;\n    }\n\n    \u002F\u002F 전환으로 이탈 시 호출 (SceneTransManager가 Exit() 호출)\n    protected override async Task onExit()\n    {\n        \u002F\u002F 씬 퇴장 시 정리 로직\n        await Task.CompletedTask;\n    }\n}\n```\n\n---\n\n## Non-goals\n\n- **페이드 UI 직접 소유**: SceneTransManager는 CanvasGroup\u002FOverlay를 소유하지 않는다. 이벤트로 위임한다.\n- 로딩 UI \u002F 프로그레스바 \u002F 다운로드 진행률 표시는 이번 범위 밖이다.\n- DI \u002F ServiceLocator 설계 도입은 포함하지 않는다.\n- Addressables 라벨\u002F키 정책 변경은 포함하지 않는다.\n\n---\n\n## Bootstrap Prefab에 포함\n\nSceneTransManager는 Bootstrap prefab에 포함된다.\n이로써 부팅과 씬 전환이 일관된 파이프라인으로 동작한다.\n\nBootstrap prefab에는 BaseApplication 파생 컴포넌트가 정확히 1개 필요하다 (개발자가 직접 추가).\n\n---\n\n## Reference\n\n- Parent: `skills\u002Fdevian-unity\u002F20-common-package\u002F00-overview\u002FSKILL.md`\n- AssetManager: `skills\u002Fdevian-unity\u002F20-common-package\u002F13-asset-manager\u002FSKILL.md`\n- Singleton: `skills\u002Fdevian-unity\u002F20-common-package\u002F29-singleton\u002FSKILL.md`\n- Base Application: `skills\u002Fdevian-unity\u002F20-common-package\u002F14-base-application\u002FSKILL.md`\n",{},"main","8cb5bd877a3a7004867d2f55697cb9e4ff2f1734","skills\u002Fdevian-unity\u002F20-common-package\u002F28-scene-trans-manager","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian","https:\u002F\u002Fgithub.com\u002Fdevwinsoft","Kim Hyong Joon","2026-04-12 18:44:10",{"source":7,"skillName":5,"commands":31,"prompt":41,"zipAvailable":42},[32,35,38],{"tool":33,"command":34},"npx","npx skills add devwinsoft\u002Fdevian --skill 28-scene-trans-manager",{"tool":36,"command":37},"bunx","bunx skills add devwinsoft\u002Fdevian --skill 28-scene-trans-manager",{"tool":39,"command":40},"pnpm","pnpm dlx skills add devwinsoft\u002Fdevian --skill 28-scene-trans-manager","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian-unity\u002F20-common-package\u002F28-scene-trans-manager\u002FSKILL.md",true,[],[45,51,59,67,76,83],{"skillNo":46,"name":47,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":48,"categories":49,"keywords":50,"publishedAt":19},"01M6CBX3K2JJV38ANHVGCAT8A0","devian","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002FSKILL.md",[],[47],{"skillNo":52,"name":53,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":54,"categories":55,"keywords":56,"publishedAt":19},"01M6CBX210BFMM8AMN770J9WY8","90-project-archive","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002F80-tools\u002F90-project-archive\u002FSKILL.md",[],[57,58],"archive","90 project archive",{"skillNo":60,"name":61,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":62,"categories":63,"keywords":64,"publishedAt":19},"01M6CBWZSGRR9R3YJZB3177667","30-env-management","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002F80-tools\u002F30-env-management\u002FSKILL.md",[],[65,66],"management","30 env management",{"skillNo":68,"name":69,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":70,"categories":71,"keywords":72,"publishedAt":19},"01M6CBWYD3TGWBQV7V35551THF","19-page-push-send","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002F80-tools\u002F20-operation\u002F19-page-push-send\u002FSKILL.md",[],[73,74,75],"push","page","19 page push send",{"skillNo":77,"name":78,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":79,"categories":80,"keywords":81,"publishedAt":19},"01M6CBWWRQ05A7604GHJKTPJTF","18-page-savedata","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002F80-tools\u002F20-operation\u002F18-page-savedata\u002FSKILL.md",[],[74,82],"18 page savedata",{"skillNo":84,"name":85,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":86,"categories":87,"keywords":88,"publishedAt":19},"01M6CBWVH4S2VF1V7B2GBTESCT","17-page-deobfuscate","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002F80-tools\u002F20-operation\u002F17-page-deobfuscate\u002FSKILL.md",[],[74,89],"17 page deobfuscate"]