状态机 · 使用说明

〇两种形态：先选对（30 秒）

同一个模块里给了两种状态机 —— 不是"新旧"，是两种用法。

一轻量状态机：3 分钟写游戏流程

目标：登录 → 大厅 → 战斗，三个状态互相切换。

// ① 状态：继承 RevLightStateBase，重写关心的回调（三个都是可选的）
public class LoginState : RevLightStateBase
{
    public override void OnEnter()  { /* 打开登录界面、连服务器 */ }
    public override void OnUpdate(float dt) { /* 需要每帧做的事 */ }
    public override void OnExit()   { /* 关界面、清理 */ }
}
public class LobbyState  : RevLightStateBase { }
public class BattleState : RevLightStateBase { }

// ② 建机器 + 注册状态（T 写你要共用的基类/接口）
var flow = new RevLightStateMachine<RevLightStateBase>();
flow.Register(new LoginState());
flow.Register(new LobbyState());
flow.Register(new BattleState());

// ③ 切状态（走 OnExit → OnEnter）
flow.ChangeTo(flow.CurrentState is LoginState ? GetLobby() : GetBattle());

// ④ 每帧驱动（谁来调见第五节）
flow.Update(Time.deltaTime);

// ⑤ 想监听切换（埋点、日志、音效）
flow.StateChanged += (from, to) => RevLog.Info($"流程：{from?.GetType().Name} → {to?.GetType().Name}", "Flow");

// ⑥ 常用查询
bool inBattle = flow.Is<BattleState>();
float t = flow.StateTime;              // 当前状态已经持续了多久（做超时很有用）

二重量级状态机：3 分钟给 Boss 写状态

关键设计：状态类只面向"行为接口"编程，不认识具体 MonoBehaviour —— 所以状态逻辑能单测。

// ① 定义宿主的行为接口：Boss 有哪些能力，由业务说（继承 RevIHeavyFsmOwner 标记接口）
public interface IBossObj : RevIHeavyFsmOwner
{
    float Health { get; }
    void MoveTo(Vector3 pos);
    void PlayAnim(string name);
}

// ② 状态枚举：Boss 有哪些状态
public enum BossState { Idle, Chase, Attack, Die }

// ③ 状态类：泛型参数 = （状态枚举, 宿主接口）
public class BossChaseState : RevHeavyFsmState<BossState, IBossObj>
{
    public override void OnEnter()
    {
        Owner.PlayAnim("run");                    // Owner 就是宿主（IBossObj）
    }
    public override void OnUpdate(float dt)
    {
        Owner.MoveTo(PlayerPos());
        if (NearPlayer()) Fsm.ChangeState(BossState.Attack, "进入攻击距离");
    }
    public override void OnExit() { Owner.PlayAnim("idle"); }
}

// ④ 组装 + 驱动（宿主类里：Boss 自己实现 IBossObj）
_fsm = new RevHeavyFsm<BossState, IBossObj>(this);
_fsm.AddState(BossState.Idle,   new BossIdleState());
_fsm.AddState(BossState.Chase,  new BossChaseState());
_fsm.AddState(BossState.Attack, new BossAttackState());
_fsm.ChangeState(BossState.Idle, "初始化");

void Update()      { _fsm.UpdateState(Time.deltaTime); }        // 每帧驱动
void FixedUpdate() { _fsm.FixedUpdateState(Time.fixedDeltaTime); }
void OnDestroy()   { _fsm.Dispose(); }

三对照表（两套 API 全列）

轻量：RevLightStateMachine<T>

重量级：RevHeavyFsm<TStateEnum, TOwner>

四返回栈状态机（UI 栈 / 流程栈）

当"新状态压在旧状态上面，退出后回到上一个"时，用栈版本。

// 界面栈：设置界面压在背包上面，返回时回到背包
var uiStack = new RevLightStackStateMachine<RevLightStateBase>();

uiStack.Push(new BagState());        // 压入（原来那个被挂起：OnSuspend）
uiStack.Push(new SettingsState());   // 再压一个

var top = uiStack.Pop();               // 弹出 → 下面那个自动 OnResume 回来
var under = uiStack.Under;             // 只在"下面那个"上做点事（不弹它）
int n = uiStack.Count;                 // 栈里几个

uiStack.Change(new ShopState());         // 替换栈顶（Pop + Push 一步）
uiStack.Clear();                        // 全清（回主界面）

uiStack.StatePushed += s => RevLog.Info($"进入 {s.GetType().Name}", "UIStack");
uiStack.StatePopped += s => RevLog.Info($"退出 {s.GetType().Name}", "UIStack");

五谁负责每帧驱动（最常问）

状态机是纯逻辑：它不自己挂物体、不自己抢 Update —— 由你决定在哪驱动，这样它才能被单测。

六新手最容易踩的 5 个坑

七相关文档

• 《状态机 · 架构解析》 —— 设计论证：两种形态的分工、泛型宿主接口为什么这么设计、异步切换的实现
• 《状态机 Demo 示例讲解》 —— Boss AI / 游戏流程 / UI 栈三个完整例子
• 《公共 Mono 模块 · 使用说明》 —— 纯 C# 流程管理器怎么拿每帧回调
• 文档总入口 · 在线文档站