状态机 Demo 实战讲解（对标参考实现真实业务）

0三个 Demo 一览

三个 Demo 都不需要任何场景布置（不需要 UI、Prefab、模型），挂一个空物体就能跑，左上角有实时面板，Console 有完整流转日志。

1怎么跑 + 目录结构

1. 把 Revolution.Demo\Unity\RevStateMachine\ 整个目录拷进 Unity 工程的 Assets 下（位置随意）
2. 场景里新建空物体，按需挂上三个组件之一：
   · RevDemoGameFlow      —— Demo 1（轻量·主流程）
   · RevDemoUiStackDemo   —— Demo 2（轻量·UI 栈）
   · RevDemoBossAI        —— Demo 3（重量级·Boss AI）
3. Play，按左上角面板上的提示按键

RevStateMachine\
├── LightweightFlow\            Demo 1：轻量级·单状态机（游戏主流程）
│   ├── RevDemoBattleAssetService.cs   模拟"战斗资源"异步加载/释放（真实项目=资源系统）
│   ├── RevDemoGameFlowStates.cs       5 个流程状态（登录/大厅/匹配/战斗加载/战斗）
│   └── RevDemoGameFlow.cs             ★ 驱动：注册状态、驱动 Update、假 UI 按键
├── LightweightUiStack\         Demo 2：轻量级·栈状态机（UI 界面栈）
│   ├── RevDemoUiStates.cs             4 个界面状态（主界面/背包/设置/帮助）
│   └── RevDemoUiStackDemo.cs          ★ 驱动：Push/Pop、面包屑快照、栈面板
└── HeavyweightBossAI\          Demo 3：重量级（枚举 + 行为接口）
    ├── RevDemoBossDefine.cs           枚举 ×2 + 宿主行为接口
    ├── RevDemoBossStates.cs           主状态机 6 个状态 + 技能状态机 3 个状态
    └── RevDemoBossAI.cs               ★ 宿主：注册状态、三路驱动、全局规则、两台机器

2Demo 1：轻量级·单状态机 —— 游戏主流程

2.1 参考实现业务背景

参考实现①的 StateMachine（非泛型栈式）有 8+ 业务在用，"游戏主流程"就是其中一条： 登录 → 大厅 → 匹配 → 战斗加载 → 战斗。这条链路之所以适合当 Demo，是因为它同时包含两种切换：

2.2 状态流转

        ┌──────────┐  登录成功(异步)   ┌────────┐  按[1]   ┌──────────┐
        │ Login    │ ───────────────▶ │ Lobby  │ ───────▶ │ Matching │
        └──────────┘                  └────────┘          └──────────┘
                                         ▲ 按[2]取消          │ 匹配成功(异步)
                                         │                    ▼
                                         │            ┌──────────────────┐
                                         │            │ BattleLoading    │← 读条中按[2]取消
                                         │            └──────────────────┘
                                         │                    │ 资源就绪 → ChangeToAsync
                                         │                    ▼（等 Battle 的 PrepareEnterAsync）
                                         │            ┌──────────────────┐
                                         └── 战斗结束 ─│ Battle           │
                                                       └──────────────────┘

2.3 关键代码逐段讲解

① 注册：固定状态用实例、带参数的状态用工厂

// 固定状态 → 注册实例（复用同一个对象：切到"已经是当前状态"时会被自动跳过）
_sm.Register(new RevDemoLoginState(_sm));
_sm.Register(new RevDemoLobbyState(_sm));
_sm.Register(new RevDemoMatchingState(_sm));
_sm.Register(new RevDemoBattleLoadingState(_sm));

// 带参数的状态 → 注册工厂（每局给新实例：战斗模式可能不同）
_sm.Register<RevDemoBattleState>(() => new RevDemoBattleState(_sm, _nextBattleMode));

// 之后按类型切
_sm.ChangeTo<RevDemoMatchingState>();

② 同步切换 vs 事务式切换

// 同步：立刻交割（输入响应类）
_sm.ChangeTo<RevDemoMatchingState>();

// 事务式：等目标状态自己说"我准备好了"（Battle.PrepareEnterAsync 播完进场演出）
await _sm.ChangeToAsync<RevDemoBattleState>();

// ★ await 回来必须确认（被更新的请求取代时，状态不变且不抛异常）
if (!_sm.Is<RevDemoBattleState>()) Debug.Log("本次切换被取代/取消");

③ PendingState 兜底释放 —— 本 Demo 最值钱的一段

public override void OnExit()
{
    // PendingState = "当前事务要去哪"（= 参考实现①的 tarState，持久保留语义）
    if (_sm.PendingState is RevDemoBattleState)
        Debug.Log("离开加载态且目标就是战斗 → 资源保留给战斗使用");
    else
    {
        Debug.Log("离开加载态，但目标不是战斗 → ★ 兜底释放战斗资源");
        RevDemoBattleAssetService.Release();
    }
}

④ 异步流程回来先"验活"

private async RevTask MatchAsync()
{
    await RevTask.Delay(2000);

    // ★ 期间玩家可能已经取消（切回大厅）→ 不能继续推进流程
    if (!ReferenceEquals(_sm.CurrentState, this))
    { Debug.Log("结果回来时已不在匹配态 → 丢弃"); return; }

    _sm.ChangeTo<RevDemoBattleLoadingState>();
}

2.4 跑起来会看到什么（Console 日志节选）

[主流程] 进入【登录】：开始异步登录（模拟 1 秒）
[主流程] 登录成功 → 切到大厅
[主流程] 状态变化：RevDemoLoginState → RevDemoLobbyState
[按键] 开始匹配
[主流程] 进入【匹配中】：开始匹配（约 2 秒，期间可按 [2] 取消）
[主流程] 匹配成功 → 切到【战斗加载】
[主流程] 进入【战斗加载】：读条开始（按 [2] 可在读条中取消，观察资源兜底释放）
[资源] 战斗资源加载中… 33% / 66% / 100%
[主流程] 资源就绪 → 发起事务式切换（等战斗态准备好）
[战斗] 进入准备：播放进场演出（5v5）…
[主流程] 离开【战斗加载】，目标就是战斗 → 资源保留给战斗使用
[战斗] 进入【战斗】（5v5）：开打！3 秒后自动结束

故意在读条中按 [2]，就会看到兜底那条：

[主流程] 离开【战斗加载】，但目标不是战斗 → ★ 兜底释放战斗资源
[资源] ★ 战斗资源已释放

2.5 这个 Demo 能答的面试题

• "流程切换要不要等资源？" → 分两类：必须马上切的用同步；等资源 / 等演出的用事务式。两边混用才是常态。
• "加载到一半玩家退出了，会不会漏资源？" → 不会：用 PendingState（tarState）判"本来要去哪"，目标不对就兜底释放 —— 这是参考实现 LoadingState 的真实做法。
• "异步回调回来时状态已经变了怎么办？" → 先验活（CurrentState == this），不满足就丢弃结果。

3Demo 2：轻量级·栈状态机 —— UI 界面栈

3.1 参考实现业务背景

参考实现③ StackStateMachine<T> 的官方示例场景就是 UI 界面栈。栈语义的灵魂在 OnSuspend / OnResume：

主界面 ─Push─▶ 背包 ─Push─▶ 设置 ─Push─▶ 帮助·第1层 ─Push─▶ 帮助·第2层
   ▲ OnSuspend（禁用点击，但不销毁）
   │                                       Pop◀─ 逐级 OnResume（数据都还在，不用重拉）

3.2 关键代码逐段讲解

① 实例注册 vs 工厂注册（这里体现得最明显）

// 同一时刻只可能有一个 → 实例注册
_sm.Register(new RevDemoUiLobbyState());
_sm.Register(new RevDemoUiBagState());
_sm.Register(new RevDemoUiSettingsState());

// 帮助弹窗可以叠多层 → 工厂注册（每次 Push 都拿新实例）
_sm.Register<RevDemoUiTipsState>(() => new RevDemoUiTipsState(++_tipsLayer));

② 只有栈顶被驱动（可量化验证）

// 每个状态自己数帧：OnUpdate 里 UpdatedFrames++
public override void OnUpdate(float deltaTime) => UpdatedFrames++;

Demo 面板会把每个状态的帧数摊出来：栈顶那个数字一直在涨，被压住的全部停住 —— 这就是"只有栈顶被 Update 驱动"的直观证据。

③ 面包屑：框架不给，就自己维护（推荐做法）

// 栈用 Stack<T> 承载（只有 LIFO，读不了"倒数第 N 层"），所以业务订阅事件同步一份路径快照
_sm.StatePushed += state => _breadcrumb.Add(state);
_sm.StatePopped += state => _breadcrumb.Remove(state);

④ 四种结构操作的区别

3.3 真实用途对照

3.4 这个 Demo 能答的面试题

• "为什么 UI 栈不能只用 Enter/Exit？" → 因为返回时不该重建：OnSuspend/OnResume 保住了数据、滚动位置、入场动画状态。
• "栈里的状态谁在被 Update？" → 只有栈顶；被压住的暂停（Demo 里的帧数计数就是证据）。
• "怎么画面包屑？" → 订阅 StatePushed/StatePopped 自己维护路径快照，而不是要求框架提供按下标访问。

4Demo 3：重量级 —— Boss AI（枚举 + 行为接口）

4.1 参考实现业务背景

怪物 AI / Boss AI 是重量级状态机的正主（对应参考实现④ FSM<T>：枚举当键 + 事务式切换）。 为什么这类业务要这两样东西：

4.2 组合两台状态机（而不是分层状态机）

RevDemoBossAI（宿主）
├── 行为机 RevHeavyFsm<RevDemoBossStateType, IRevDemoBoss>   Idle / Patrol / Chase / Combat / Phase2 / Dead
└── 技能机 RevHeavyFsm<RevDemoBossSkillType, IRevDemoBoss>   None / Casting / Cooldown

两者的接线只有一行 —— 状态通过宿主发起请求，宿主决定交给哪台机器：

// 战斗状态里：请求放技能（状态只管"要放"，不关心技能机怎么实现）
Owner.RequestCastSkill();

// 宿主里：转发给技能机
public void RequestCastSkill()
{
    if (_skillFsm.IsTransitioning || _skillFsm.CurrentStateType != RevDemoBossSkillType.None) return;
    _skillFsm.ChangeState(RevDemoBossSkillType.Casting, "战斗状态下请求释放技能");
}

4.3 关键代码逐段讲解

① 三路驱动：位移放 FixedUpdate

private void Update()      { CheckGlobalRules(); _fsm.UpdateState(Time.deltaTime); _skillFsm.UpdateState(Time.deltaTime); }
private void FixedUpdate() { _fsm.FixedUpdateState(Time.fixedDeltaTime); _skillFsm.FixedUpdateState(Time.fixedDeltaTime); }
private void LateUpdate()  { _fsm.LateUpdateState(Time.deltaTime); }   // 表现纠偏

② 全局规则集中判断（AI 里最容易踩的坑）

private void CheckGlobalRules()
{
    if (_hp > 0f) return;
    if (_fsm.CurrentStateType == RevDemoBossStateType.Dead) return;
    _fsm.ChangeState(RevDemoBossStateType.Dead, "血量归零");
}

③ 事务式切换：二阶段等资源与演出

// 战斗状态里：血量过半 → 事务式切二阶段（期间战斗照常进行，玩家不会看到僵住）
ChangeToAsync(RevDemoBossStateType.Phase2, "血量低于 50%").Forget();

// 二阶段状态里：资源与演出没完，就不允许交割
public override async RevTask PrepareEnterAsync(RevCancellationToken token)
{
    await RevTask.Delay(900);   // 真实项目：await RevResManager.LoadAsync<GameObject>("Boss/Phase2Fx", token)
}

④ 切换原因 + 历史（参考实现 2024 才补的能力）

_fsm.ChangeState(RevDemoBossStateType.Chase, "发现玩家");        // 带原因

// 按 [L] 打印：
//     12.34s  Idle → Combat（玩家已在攻击范围内）
//     15.02s  Combat → Phase2（血量低于 50%）
foreach (var t in _fsm.GetHistory()) Debug.Log($"    {t.Time:F2}s  {t}");

⑤ 日志出口可接管

RevHeavyFsmLog.Sink = message => Debug.Log(message);   // 接到 Unity 控制台；真实项目换成统一日志系统

框架的诊断日志是 [Conditional("UNITY_EDITOR")] 的（正式包零开销），需要线上排查时把它接到自研日志系统即可。

4.4 这个 Demo 能答的面试题

• "AI 为什么用状态机而不是一堆 if-else？" → 条件只在自己状态下成立、进出有明确回调、能查历史原因；if-else 堆叠到 6 个状态以上就无法维护。
• "Boss 二阶段既要加载又要演出，怎么保证不出穿帮？" → 事务式切换：ChangeToAsync + PrepareEnterAsync，资源 / 演出就绪才交割。
• "多个状态机怎么协作？" → 组合多台（行为机 + 技能机），由宿主做接线；不要"父状态套子状态机"。
• "死了还在攻击这种 bug 怎么根除？" → 全局规则集中判断（CheckGlobalRules），不散落到每个状态。

5三个 Demo 的技术点清单（可直接用于简历 / 面试）

6验证结果与已知取舍