目录— 个文件
⌕
目录加载中…
…/core/base/IFrameworkManager.ts
1/**
2 * 管理器接口,定义了管理器的生命周期方法
3 */
4export interface IFrameworkManager {
5
6 /**
7 * 管理器名称
8 */
9 Name: string;
10 /**
11 * 初始化方法,在管理器创建后调用
12 */
13 Init(): Promise<void>;
14
15
16
17 /**
18 * 反初始化方法,在管理器销毁前调用
19 */
20 DeInit(): void;
21
22 /**
23 * 更新方法,在每帧更新时调用
24 * @param deltaTime 时间增量,单位为秒
25 */
26 Update(deltaTime: number): void;
27}
讲解28 行
管理器生命周期接口人工通读
IFrameworkManager.ts
定义框架管理器必须实现的四个成员:名称、初始化、反初始化和逐帧更新。入口把管理器收进数组后用这个接口统一驱动,业务模块与框架模块都实现它,因此接口本身不含任何逻辑,只约定调用时机与签名。
文件很短,先看 Name 与 Init 的注释,再对照 Entry 里 Init、Update、DeInit 三个循环理解调用顺序。
特殊处理与易错点
- 设计Init 返回 Promise,入口可以 await 串行完成初始化,实现类若在内部发异步请求必须自己 await 到底再 resolve。L13
- 特殊处理Name 是实例字段而不是静态字段,日志里作为模块名使用,实现类必须自己赋固定字符串,接口不提供默认值。L9
- 设计DeInit 与 Update 都是同步 void,销毁和每帧更新不允许异步,需要异步清理只能在 DeInit 里发起后不等待。L20
9属性管理器名称,用于日志与排查,实现类赋值。
13方法契约方法,管理器创建后由入口 await 调用,实现类在这里完成自身初始化。
20方法契约方法,管理器销毁前由入口同步调用,实现类在这里注销监听并释放资源。
26方法契约方法,每帧由入口调用一次,实现类按传入的秒级增量推进自身逻辑。