找物源码导读Cocos Creator 3.8 · assets/scripts
0%
已读 0 / 424
目录— 个文件
目录加载中…
…/bridge/procedure/ProcedureLoading.ts
1import { LoadingData, LoadingDataMap, LoadingTag } from "../../runtime/manager/loading/define/LoadingDefine";
2import { Runtime } from "../../runtime/Runtime";
3import { Framework } from "../../framework/Framework";
4import { ScenePath } from "../scene/ScenePath";
5import { ProcedureBase } from "../../framework/core/procedure/ProcedureBase";
6import { registerProcedure } from "../../framework/core/procedure/ProcedureClassRegistry";
7import { ProcudureEnum } from "./ProcudureEnum";
8
9/**
10 * 加载流程
11 */
12@registerProcedure(ProcudureEnum.Loading)
13export class ProcedureLoading extends ProcedureBase {
14 procedureType = ProcudureEnum.Loading;
15
16 // 显示名称由项目枚举提供,保持原日志名称。
17 get Name(): string {
18 return ProcudureEnum[this.procedureType];
19 }
20
21 //加载完成之后的目标流程
22 private data!: LoadingData;
23
24 Init() {
25 super.Init();
26 }
27
28 Enter(args: LoadingTag | { tag: LoadingTag; fromProcedure?: ProcudureEnum }, fromProcedure?: number | null): void {
29 // 加载参数只由项目解释;实际切换来源优先,无来源时沿用显式对象参数。
30 let tag: LoadingTag;
31 let sourceProcedure = fromProcedure;
32 if (typeof args === "object" && args !== null) {
33 tag = args.tag;
34 if (sourceProcedure == null) sourceProcedure = args.fromProcedure;
35 } else {
36 tag = args;
37 }
38 // 从大厅或冷启动进入找物时,覆盖完整的关卡资源加载阶段。
39 if (tag === LoadingTag.GameFind) Runtime.GameFind.LevelLoadStartMs = Date.now();
40 this.data = LoadingDataMap.get(tag)!;
41 this.data.FromProcedure = sourceProcedure ?? undefined;
42
43 // 优化时序:先切到 LoadingScene,再由 LoadingScene 在真正开始加载前等待逻辑准备完成
44 Framework.Scene.SwitchScene(ScenePath.LoadingScene, this.data);
45 }
46
47 Leave(): void {
48 }
49
50 Update(deltaTime: number): void {
51 }
52
53
54 /**
55 * 加载完成
56 * @constructor
57 * @private
58 */
59 public LoadingComplete() {
60 Framework.Log.Warn("Loading 流程完成", { target: ProcudureEnum[this.data.TargetProcedure] ?? this.data.TargetProcedure });
61 Framework.Log.Warn("开始进入目标流程");
62 //加载完成 进入下一个流程
63 Framework.Procedure.StartProcedure(this.data.TargetProcedure, this.data.Params);
64 }
65
66}
讲解67 行
加载流程人工通读

ProcedureLoading.ts

负责场景切换的中间流程节点,注册为 ProcudureEnum.Loading。它把 LoadingTag 解释为加载数据,记录来源流程与关卡加载起点时间,然后切到 LoadingScene;场景加载完成后由 LoadingComplete 进入数据里声明的目标流程。

先看 Enter 对两种参数形态的兼容处理,再看 LoadingComplete 如何用 data.TargetProcedure 跳转。

特殊处理与易错点

12注释加载流程
13注释ProcedureLoading:ProcedureLoading 是「流程桥」目录下的流程状态。描述一个游戏流程状态的进入、
17方法以当前流程编号为键从 ProcudureEnum 取名称,供父类日志显示使用。
22注释加载完成之后的目标流程
24方法只调用父类 Init 完成流程基类初始化,自身不追加逻辑。
28方法解析参数得到加载标记与来源流程,记录关卡加载起点,取出加载数据后切到 LoadingScene。
30注释加载参数只由项目解释;实际切换来源优先,无来源时沿用显式对象参数。
39注释从大厅或冷启动进入找物时,覆盖完整的关卡资源加载阶段。
44注释优化时序:先切到 LoadingScene,再由 LoadingScene 在真正开始加载前等待逻辑准备完成
47方法空实现,离开加载流程时不执行清理。
50方法空实现,加载流程不参与每帧更新。
59方法打印目标流程日志,然后用加载数据里的目标流程与参数启动下一个流程。
63注释加载完成 进入下一个流程