找物源码导读Cocos Creator 3.8 · assets/scripts
0%
已读 0 / 424
目录— 个文件
目录加载中…
…/core/procedure/ProcedureManager.ts
1import { Framework } from "../../Framework";
2import { frameworkManager } from "../base/FrameworkClassRegistry";
3import { IFrameworkManager } from "../base/IFrameworkManager";
4import { Singleton } from "../base/Singleton";
5import { ProcedureBase } from "./ProcedureBase";
6
7/**
8 * 流程管理器
9 * 贯穿整个游戏流程
10 */
11@frameworkManager()
12export class ProcedureManager extends Singleton<ProcedureManager> implements IFrameworkManager {
13
14 public Name = "ProcedureManager";
15
16 // 新增:过程类注册表(枚举值 → 类构造函数)
17 private static procedureRegistry: Map<number, new () => ProcedureBase> = new Map();
18
19 private procedures: { [key: number]: ProcedureBase | undefined } = {};
20 /**
21 * 当前流程
22 * @private
23 */
24 private curProcedure: ProcedureBase | undefined;
25
26 /**
27 * 获取当前流程
28 */
29 public get CurProcedure(): ProcedureBase {
30 return this.curProcedure!;
31 }
32
33 /**
34 * 对外暴露的注册方法
35 * @param enumValue 流程枚举
36 * @param clazz 流程类
37 * @constructor
38 */
39 public static RegisterProcedure(enumValue: number, clazz: new () => ProcedureBase) {
40 this.procedureRegistry.set(enumValue, clazz);
41 }
42
43 public async Init(): Promise<void> {
44 Framework.Log.Log(this.Name, "Init", "初始化流程管理器");
45
46 // 项目在入口导入时完成注册;按 ID 创建,保持原枚举顺序。
47 const registeredProcedures = Array.from(ProcedureManager.procedureRegistry.entries());
48 registeredProcedures.sort(([left], [right]) => left - right);
49 for (const [procedureId, clazz] of registeredProcedures) {
50 this.procedures[procedureId] = new clazz();
51 }
52 }
53
54 public DeInit(): void {
55 }
56
57 Update(deltaTime: number): void {
58 if (this.curProcedure) {
59 this.curProcedure.Update(deltaTime);
60 }
61 }
62
63 /**
64 * 开始流程
65 * @param targetProcedureEnum 目标流程枚举
66 * @param args 目标流程参数
67 * @constructor
68 */
69 public StartProcedure(targetProcedureEnum: number, args: any = null) {
70 if (targetProcedureEnum == null) return;
71
72 let procedure = this.procedures[targetProcedureEnum];
73 if (!procedure) return;
74
75 const fromEnum = this.curProcedure?.ProcedureType ?? null;
76
77 if (this.curProcedure) {
78 if (this.curProcedure.ProcedureType === targetProcedureEnum) {
79 Framework.Log.Log("当前流程:", this.curProcedure.Name, "相同流程,直接退出");
80 return; // 相同直接退出
81 }
82 this.curProcedure.Leave();
83
84 //切换流程 销毁所有界面
85 Framework.UI.DestoryAllPanels();
86 }
87 Framework.Log.Warn("当前流程:", this.curProcedure && this.curProcedure.Name, "切换到==>目标流程:", procedure.Name);
88 this.curProcedure = procedure;
89
90 // 通用切换只传原参数与来源 ID,不解释项目加载标签。
91 this.curProcedure.Enter(args, fromEnum);
92 }
93
94 /**
95 * 判断是否流程
96 * @param procedureEnum 流程枚举
97 * @constructor
98 */
99 public IsProcudure(procedureEnum: number): boolean {
100 if (!procedureEnum) return false;
101 let procedure = this.procedures[procedureEnum];
102 if (!procedure) return false;
103 return this.curProcedure == procedure;
104 }
105
106}
讲解107 行
流程管理器人工通读

ProcedureManager.ts

框架单例,持有静态注册表、流程实例表和当前流程;每帧把 deltaTime 交给当前流程。StartProcedure 负责旧流程离场、销毁全部界面、新流程进场,是场景与 UI 切换的总入口。

先看静态注册表与 Init 的实例化顺序,再读 StartProcedure 的切换顺序,最后看 CurProcedure 与 IsProcudure。

特殊处理与易错点

  • 设计procedures 按枚举缓存流程对象,同一流程多次进入会复用同一实例,内部状态必须在 Leave 中清理。
11注释流程管理器 贯穿整个游戏流程
12注释ProcedureManager:流程状态机:创建并持有当前 ProcedureBase,StartProcedure 执行旧
17注释新增:过程类注册表(枚举值 → 类构造函数)
19属性按枚举值索引的流程实例表,Init 填充,StartProcedure 和 IsProcudure 读取。
24属性当前运行中的流程实例,StartProcedure 写入,Update 读取。
29方法返回当前流程实例,尚未开始任何流程时值实际为 undefined,内部使用非空断言。
39方法静态方法,把流程枚举与构造函数写入类级注册表,供 Init 按序实例化。
43方法按枚举值升序实例化静态注册表内的流程,写入实例表,不调用任何流程回调。
47注释项目在入口导入时完成注册;按 ID 创建,保持原枚举顺序。
54方法空实现,重启时不做流程表清理,流程实例随管理器单例保留。
57方法每帧把 deltaTime 转给当前流程的 Update,没有当前流程时什么都不做。
69方法校验枚举与实例,不同流程时先 Leave 再销毁全部面板,随后赋值为当前流程并 Enter 新流程。
85注释切换流程 销毁所有界面
91注释通用切换只传原参数与来源 ID,不解释项目加载标签。
99方法先排除空枚举和不存在的流程,再比较实例引用判断是否为当前流程。