公共 Mono 模块 · 使用说明

〇它是干什么的

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

RevMono.AddUpdate(OnTick);                              // ① 让一个纯 C# 方法每帧被调
RevMono.AddLateUpdate(FollowCam, owner: this);       // ② 每帧最后（相机/UI 跟随）
RevMono.StartCoroutine(Run());                          // ③ 纯 C# 类也能跑协程

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

不用配置、不用继承 MonoBehaviour、不用摆物体。

public sealed class NetworkHeartbeat          // ← 注意：纯 C# 类，没有继承 MonoBehaviour
{
    public void Start()
    {
        RevMono.AddUpdate(Tick, owner: this);            // 每帧推进（owner 用于一行收尾）
        RevMono.StartCoroutine(PingLoop());              // 跑协程（隐藏宿主替它跑）
    }

    public void Stop() => RevMono.RemoveAllOf(this);   // ★ 一行：摘监听（协程请配合作用域，见第五节）

    private void Tick()
    {
        // 每帧要做的事（轻活；重活交给 RevTask / 线程）
    }

    private IEnumerator PingLoop()
    {
        while (true)
        {
            // 发心跳 ...
            yield return new WaitForSecondsRealtime(5f);
        }
    }
}

// 用起来就一行：
var heartbeat = new NetworkHeartbeat();
heartbeat.Start();        // 之后每帧自动 Tick，心跳每 5 秒一次

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

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

三三个相位怎么选（执行顺序）

它们就是 MonoBehaviour 的 Update / LateUpdate / FixedUpdate，语义完全一致。

四别选错：和 RevTimer / RevTask 的分工

框架里有三个"看起来都能做定时/异步"的东西，选错了要么写得更累，要么性能吃亏。

RevTimer.Every(0.016f, Tick);
// 间隔和帧长对不齐 → 有时一帧跑两次、有时一帧不跑
// 而且每帧都要过一次到期判定

RevMono.AddUpdate(Tick, owner: this);
// 一帧一次，语义就是"每帧"

五协程：纯 C# 类也能跑

协程真正的价值是"能 yield 一帧 / 等一秒 / 等条件"，写流程比状态机直观。

// 起：返回 Unity 的 Coroutine 句柄（可单独停）
Coroutine co = RevMono.StartCoroutine(OpenPanelStep());

private IEnumerator OpenPanelStep()
{
    panel.PlayOpen();
    yield return new WaitForSecondsRealtime(0.3f);   // 等真实时间（不受 timeScale 影响）
    while (!resourceReady) yield return null;            // 等条件（每帧检查）
    panel.ShowContent();
}

// 停：单条 / 全停
RevMono.StopCoroutine(co);
RevMono.StopAllCoroutines();

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

"忘记移除监听"是这类模块唯一的泄漏方式，两种方式根治。

RevMono.AddUpdate(Tick, owner: this);
RevMono.AddLateUpdate(FollowCam, owner: this);

public void Dispose() => RevMono.RemoveAllOf(this);   // ← 一行，全摘

using (var scope = RevMono.OpenScope())
{
    scope.AddUpdate(OnTick);                     // 这块里加的监听归 scope 管
    scope.StartCoroutine(RunSequence());         // 这块里起的协程也归 scope 管
}   // ← 出块：监听全摘、协程全停

七去重与上限（为什么我的监听没加进去）

两个刻意的防线，都会通过返回值告诉你。

7.1 派发期间增删的语义（可依赖）

这个语义是刻意的：名单在本帧内不会变，所以回调里想做什么都不会"改坏"遍历（旧实现用 C# 事件，也无法保证这一点）。

八新手最容易踩的 6 个坑

每条都会让人白干一阵子。

九不生效怎么查（3 分钟）

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

十附：文件清单 / 验收 / 与旧 MonoMgr 对照

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

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

10.2 验收情况

10.3 与早期实现 MonoMgr 的对照