找物源码导读Cocos Creator 3.8 · assets/scripts
0%
已读 0 / 424
目录— 个文件
目录加载中…
…/core/procedure/ProcedureBase.ts
1/**
2 * 流程基类
3 * 子类提供流程 ID 与显示名称;框架不依赖项目枚举。
4 */
5export abstract class ProcedureBase {
6
7 // 流程 ID,由各子类赋值。
8 protected procedureType!: number;
9
10 // 对外暴露当前流程枚举
11 get ProcedureType(): number {
12 return this.procedureType;
13 }
14
15 public abstract get Name(): string;
16
17 public Init(): void {
18 }
19
20 // 参数原样传递,首流程没有来源;具体流程自行解释参数。
21 public abstract Enter(args: any, fromProcedure?: number | null): void;
22
23 public abstract Update(deltaTime: number): void;
24
25 public abstract Leave(): void;
26}
讲解27 行
流程状态基类人工通读

ProcedureBase.ts

抽象类,规定每个流程子类自己提供流程编号与显示名,并实现进入、逐帧更新、退出三个方法。框架不依赖任何项目枚举,流程管理器只通过基类签名驱动子类,因此新增流程只需继承并给编号。

先看 procedureType 与 ProcedureType 的读写差异,再读 Init 空实现与三个抽象方法的参数约定。

特殊处理与易错点

5注释ProcedureBase:流程基类 子类提供流程 ID 与显示名称;框架不依赖项目枚举。
8注释流程 ID,由各子类赋值。
11方法只读返回子类赋的流程编号,供流程管理器比对与切换。
15方法抽象只读属性,由子类返回该流程的显示名称,框架与调试面板读取。
17方法空实现,子类按需重写,流程切换本身不依赖它。
21方法抽象方法,由流程管理器在切入该流程时调用,参数原样交给子类解释。
23方法抽象方法,流程激活期间每帧由管理器调用一次,子类在这里推进自身逻辑。
25方法抽象方法,由管理器在离开该流程时调用,子类在这里清理监听与界面。