计时器系统 · 使用说明

〇它是干什么的

先花 30 秒建立直觉，再动手写。

RevTimer.After(2f, () => RevUI.Close("Loading"));               // ① 2 秒后一次（最常用）
RevTimer.NextFrame(() => go.SetActive(true));                 // ② 下一帧
RevTimer.Every(1f, RefreshHp, times: 10);                     // ③ 每秒一次，共 10 次（省略 = 无限）
var h = RevTimer.Every(0.5f, UpdateCountdown); h.Left;      // ④ 句柄：剩几秒 / 进度多少

一3 分钟跑起来（可粘贴）

不用配置、不用挂脚本、不用写 Update。

// ① 延迟做一件事
RevTimer.After(1.5f, () => RevLog.Info("1.5 秒到了"));

// ② 每帧刷倒计时（UI 文本 + 填充条）
void OnEnable()
{
    _handle = RevTimer.Every(1f, Refresh, times: 10);        // 每秒一次，共 10 次
}

void Update()
{
    if (!_handle.IsAlive) return;
    countText.text = Mathf.CeilToInt((float)_handle.Left).ToString();
    fillImage.fillAmount = (float)_handle.Progress;
}

// ③ 随对象销毁一行清干净（防泄漏的关键一行）
void OnDestroy() => RevTimer.CancelAllOf(this);

二"我要做 X" 对照表（全部 API）

左边找需求，右边抄一行。所有方法签名都写在一行里，参数不用换行。

三四种时间域：选错就是线上事故

"切后台回来倒计时全错" 是这类系统最常见的线上事故 —— 根因都是没选对时间轴。

RevTimer.Every(1f, Refresh);
// 暂停游戏（timeScale=0）→ 倒计时不动了
// 玩家：这 UI 卡死了？

RevTimer.Every(1f, Refresh,
    domain: RevTimeDomain.Unscaled);
// 暂停/慢放时倒计时照走（这才是玩家预期）

RevTimer.SyncServerTime(服务器下发的UTC);                        // 收到时间就校准一次（可反复校准）
RevTimer.At(activityEndUtc, OnActivityEnd);                       // 到点做事：改设备时间也骗不过它

四句柄：停 / 暂停 / 剩余 / 进度

创建时拿到句柄；句柄过期后所有操作都是安全空操作。

var h = RevTimer.Every(0.5f, UpdateCountdown);

h.IsAlive;      // 还在跑吗（过期 → false）
h.Left;         // 剩余秒数（UI 倒计时直接用它；过期 → 0）
h.Progress;     // 0~1（UI 填充条直接用它；过期 → 1）
h.Pause();      // 冻结时间（剩余量保留）
h.Resume();
h.Restart();    // 重新计时（已走时长清零、次数复原）
h.Stop();       // 停止并回收（重复调用安全）

五一行防泄漏：owner 与作用域

"循环计时器忘了停"是唯一能把整个计时器模块拖死的错法 —— 用两种方式根治。

RevTimer.Every(1f, RefreshHp, owner: this);
RevTimer.After(3f, Close, owner: this);

void OnDestroy() => RevTimer.CancelAllOf(this);      // ← 一行，全停

using (var scope = RevTimer.OpenScope())
{
    scope.Every(1f, RefreshHp);          // 这块里建的全归 scope 管
    scope.After(3f, Close);
}   // ← 出块立刻全停；不用记句柄、新增计时器不用改收尾代码

六秒表（测耗时）

它和计时器共用同一套时间源，所以不用自己算时间，也不会泄漏。

var sw = RevTimer.StartStopwatch();                  // 默认 Scaled：测"游戏内实际耗时"
// ... 干活 ...
sw.Stop();
RevLog.Info($"耗时 {(sw.Elapsed * 1000):F1} ms");

var real = RevTimer.StartStopwatch(RevTimeDomain.Unscaled);   // 测"真实经过时间"（性能/网络/加载）

七全局暂停与"我想自己驱动"

两个高级但常用的开关。

7.1 全局暂停：RevTimer.Paused

RevTimer.Paused = true;      // 打开设置面板 / 加载中：整个模块停止推进（含 Server / Fixed 域）
RevTimer.Paused = false;     // 恢复（未到期的时间从原处继续）

7.2 自己驱动：让计时器跟着你的逻辑帧走

void Update()      => RevTimer.Tick(Time.deltaTime, Time.unscaledDeltaTime, Time.realtimeSinceStartup);
void FixedUpdate() => RevTimer.TickFixed(Time.fixedDeltaTime);

八新手最容易踩的 8 个坑

每条都有人因此白干半天。

九没触发怎么查（5 分钟定位）

按顺序排除，每步都能立刻验证。

十附：文件清单 / 验收 / 设计来源

想深入看代码或判断可信度时读这一节。

10.1 文件都在哪（你只需要读一个）

10.2 验收情况

10.3 设计来源（参考实现计时器 + 你的早期实现）