esengine/packages/core/src/ECS/Systems/IntervalSystem.ts

import { EntitySystem } from './EntitySystem';
import { Matcher } from '../Utils/Matcher';
import { Time } from '../../Utils/Time';

/**
 * 间隔系统抽象类
 * 定义一个按时间间隔处理的抽象类，继承自EntitySystem类
 * 子类需要实现process方法，用于实现具体的处理逻辑
 */
export abstract class IntervalSystem extends EntitySystem {
    /** 累积增量以跟踪间隔 */
    private acc: number = 0;
    /** 更新之间需要等待多长时间 */
    private readonly interval: number;
    /** 时间间隔的余数，用于计算下一次需要等待的时间 */
    private intervalRemainder: number = 0;

    /**
     * 构造函数，初始化时间间隔
     * @param interval 时间间隔
     * @param matcher 实体匹配器
     */
    constructor(interval: number, matcher?: Matcher) {
        super(matcher);
        this.interval = interval;
    }

    /**
     * 判断是否需要进行处理
     * 如果需要进行处理，则更新累积增量和时间间隔余数，返回true
     * 否则返回false
     */
    protected override onCheckProcessing(): boolean {
        // 更新累积增量
        this.acc += Time.deltaTime;

        // 如果累积增量超过时间间隔，则进行处理
        if (this.acc >= this.interval) {
            // 更新时间间隔余数
            this.intervalRemainder = this.acc - this.interval;
            // 重置累积增量
            this.acc = 0;
            // 返回true，表示需要进行处理
            return true;
        }

        // 返回false，表示不需要进行处理
        return false;
    }

    /**
     * 获取本系统上次处理后的实际delta值
     * 实际delta值等于时间间隔加上时间间隔余数
     */
    protected getIntervalDelta(): number {
        return this.interval + this.intervalRemainder;
    }
}