目录— 个文件
⌕
目录加载中…
…/core/timer/TimerDefine.ts
1/** 定时器接口定义 */
2export interface ITimer {
3 id: number; // 定时器唯一ID
4 type: TimerType; // 类型(延迟/间隔)
5 isActive: boolean; // 是否激活
6 isCancelled: boolean; // 是否取消
7 delayTime?: number; // 延迟执行时间(仅delay类型)
8 remainingTime?: number; // 剩余时间(delay:剩余延迟; interval:剩余总时长)
9 intervalTime?: number; // 间隔执行时间(仅interval类型)
10 totalDuration?: number; // 总执行时长(仅interval类型)
11 lastIntervalTime?: number; // 上次间隔回调时间(仅interval类型)
12 onComplete: () => void; // 完成回调(delay:执行回调; interval:结束回调)
13 onInterval?: () => void; // 间隔回调(仅interval类型)
14}
15
16//定时器类型
17export enum TimerType{
18 Delay, //延迟定时器
19 Interval, //间隔定时器
20}
讲解20 行
定时器数据结构人工通读
TimerDefine.ts
定义定时器实例接口 ITimer 与类型枚举 TimerType,统一描述延迟与间隔两种定时器的字段。TimerManager 创建、更新和取消定时器时都按这套结构读写。
先看 TimerType 两个取值,再对照 ITimer 中延迟与间隔各自使用的可选字段。
特殊处理与易错点
- 设计一个接口同时承载两种定时器,延迟型只用 delayTime 与 remainingTime,间隔型额外用 intervalTime、totalDuration 与 lastIntervalTime。
- 易错点isActive 与 isCancelled 都参与存活判断,取消时两者会被同时置值,恢复单个标记不会让定时器复活。
3属性定时器唯一 ID,由管理器自增分配,取消与移除都以它为准。
4属性定时器类型,决定 Update 走延迟还是间隔处理分支。
5属性是否仍在运行,回调触发或取消后置假。
6属性是否已被取消,Update 遇到时直接排队移除。
17注释定时器类型