场景系统 · 架构解析

源设计起源 · 为什么要做这个模块

• 没它会怎样：进度条先卡在 90%，再往回跳：Unity 的 AsyncOperation.progress 在激活前最高只到 0.9，采样值本身还会抖动 —— 于是"卡在 90% 不动"和"进度条回跳"成了两件家常便饭，玩家看到的就是"卡住了"。
• 小场景会"闪一下"：几十毫秒就加载完的场景，进度条一闪而过、画面突然切换 —— minSeconds 让进度按时间节奏走，到点才激活。
• 重复请求会互相踩：两个 LoadSceneAsync 叠着跑就是黑屏 —— 所以正在切换时忽略 + 告警，而不是排队或硬切。
• 场景名写错会一路黑到底：LoadSceneAsync 返回 null 而不是抛异常，很容易一路走到黑 —— 所以当场判掉，并报人话原因。
• 旧场景的残留会跟过来：池化实例、画面残留跟着新场景走 —— 所以默认清对象池（AutoClearPool）。
• 换来了什么：进度只增不减、到 100% 才放行；await 直接可用（或挂 OnProgress / OnLoadStart 事件）；每条失败都给得出人话原因。

本篇只讲为什么；怎么用见同目录《使用说明》。

〇三句话速览（完整用法见《使用说明》）

① 切场景      await RevScene.LoadAsync("Battle");                  // 异步（推荐）
② 接进度      RevScene.OnProgress += p => bar.value = p;            // 挂一次，全局生效
③ 收摊子      RevScene.OnLoadStart += _ => RevUI.ShutdownAll();    // 对象池框架已默认清

就这三步。剩下都是这三步的细节。

一它解决什么问题

场景切换是"看起来简单、做起来到处是坑"的典型：Unity 只给了 SceneManager.LoadSceneAsync，剩下的全靠自己。这个模块把下面这些坑一次填掉：

二四个关键设计决策（含代价）

决策 1：关掉 Unity 的自动激活（allowSceneActivation = false）

为什么：Unity 在"激活前"只把进度报到 0.9，直接等 isDone 就是"卡 90% + 瞬间跳满"。关掉自动激活后，激活时机由我们掌握 —— 显示进度到 100%（且满足最短时长）才放行。

代价：激活前新场景不参与光照/初始化，多占一点点内存；且加载期间的 Time 仍是旧场景的（所以进度用 unscaledDeltaTime，与时间缩放无关）。

决策 2：进度换算做成纯 C#（RevSceneProgressTracker）

为什么：这堆规则（0.9 归一化、只增不减、时间限速、何时允许激活）全是可验证的纯逻辑，但藏在协程 / MonoBehaviour 里就只能靠肉眼跑场景验证。抽成纯类后：时间以参数进来（Tick(raw, deltaTime)），脱机断言 20 条（含 1000 帧随机采样验证单调性）。

代价：调用方要自己把 deltaTime 喂进来（本模块由 Unity 侧 loader 负责，业务无感）。

决策 3：接入面双通道 —— await 与事件并存

为什么：

• await 版适合"切完接着干"（await RevScene.LoadAsync("Battle"); 开战斗界面）—— 用框架自带的 RevTask，不引第三方异步库；
• 事件版适合"加载界面自己管自己"（OnLoadStart 开、OnProgress 更新、OnLoaded 关），业务代码里一个 await 都不用写。

两条通道共用同一份状态（RevScene.State / Progress），混用也不会打架。想明确"故意不 await"就写 .Forget()（替代 async void，意图清晰且异常不会被吞）。

代价：事件是静态的、全局生效 —— 所以订阅方自己要负责退订（或放在长期存活的对象上）。

决策 4：切之前只自动清对象池，其余交给 OnLoadStart

为什么："哪些东西该跨场景保留"是业务决定：有的游戏保留 BGM、有的保留常驻界面、有的保留已加载的资源分组。框架替你做主就会"想保留的被清掉"。

所以：只清"肯定不该跟着走"的那一类（对象池里的旧实例），其余给一个必然被调用的时机 OnLoadStart，一行挂上即可。

代价：多写一行（换来的是"不会被框架擅自清掉东西"）。

三"轻量"具体体现在哪

四与其它模块的边界

五验证结果

断言工程是临时的（只链接 Core/ 两个纯文件），跑完即删 —— 与其它模块的"可脱机断言"做法一致。

六附：关键文件索引

七本期没做的（可后续扩展）