游戏 AI / 系统课时
给状态切换加运行时日志
给状态切换加运行时日志
状态机一旦增加到三四个状态,仅看角色表现就很难判断“为什么切换”。这一节给每次迁移记录当前状态、目标状态和触发原因,让误切换、重复请求与循环跳转都有可以追踪的诊断证据。
学习目标
- 为每次状态迁移记录 From、To 与 Reason
- 区分正常切换、重复状态请求和首次进入
- 根据连续日志定位状态循环跳转问题
一条切换日志要回答三个问题
最有诊断价值的日志不是简单写一句“进入 Chase”,而是完整描述一次迁移。至少要回答:从什么状态离开、准备进入什么状态、是哪条条件触发。
推荐保持类似下面的稳定格式:FSM Patrol -> Chase | reason=TargetVisible。固定结构比自然语言描述更容易搜索和聚合,也方便以后接入日志采集系统。
基础日志不需要同时打印位置、血量、速度等所有上下文。先建立可靠的状态迁移链,只有某个问题确实需要这些数据时,再增加对应字段,否则大量敌人同时运行时日志很快会失去可读性。
让切换 API 强制携带原因
比起要求开发者在每个调用点额外打印日志,更可靠的方式是直接让 ChangeState 接收 reason。这样所有切换都会经过同一个诊断入口,也不会因为某个调用点漏写日志而出现迁移链断裂。
using System;
public interface IState
{
string Name { get; }
void Enter();
void Exit();
}
public sealed class StateMachine
{
public IState? Current { get; private set; }
public void ChangeState(IState next, string reason)
{
if (Current is null)
{
Console.WriteLine($"FSM <none> -> {next.Name} | reason={reason}");
Current = next;
Current.Enter();
return;
}
// 重复请求不会重新执行生命周期,但开发阶段仍记录诊断信息。
if (ReferenceEquals(Current, next))
{
Console.WriteLine($"FSM skip {Current.Name} -> {next.Name} | reason={reason}");
return;
}
string from = Current.Name;
Current.Exit();
Current = next;
Current.Enter();
Console.WriteLine($"FSM {from} -> {Current.Name} | reason={reason}");
}
}
public sealed class NamedState : IState
{
public string Name { get; }
public NamedState(string name)
{
Name = name;
}
public void Enter()
{
}
public void Exit()
{
}
}
public static class Program
{
public static void Main()
{
var machine = new StateMachine();
var patrol = new NamedState("Patrol");
var chase = new NamedState("Chase");
machine.ChangeState(patrol, "Spawn");
machine.ChangeState(chase, "TargetVisible");
machine.ChangeState(chase, "TargetStillVisible");
machine.ChangeState(patrol, "TargetLost");
}
}预期输出
FSM <none> -> Patrol | reason=Spawn
FSM Patrol -> Chase | reason=TargetVisible
FSM skip Chase -> Chase | reason=TargetStillVisible
FSM Chase -> Patrol | reason=TargetLost这里特意保留了 skip 日志。它能暴露调用方是否在每帧重复请求当前状态。开发阶段这类信号很有价值;正式版如果日志量过大,可以降低它的日志级别或直接关闭,但不应重新执行 Exit 和 Enter。
让原因保持稳定可检索
reason 最好使用短而稳定的标识,例如 TargetVisible、TargetLost、HealthDepleted、AttackRangeReached。不要让不同调用点随意写“发现玩家”“看到目标”“玩家进入视野”这类同义文本,否则后续很难准确检索同一种切换原因。
当判断条件需要动态数值时,可以保持主原因稳定,再增加独立诊断字段。例如因为距离过远退出追击时,主原因仍使用 TargetTooFar,而实际距离可以另外记录为 distance=12.4。这样既方便机器聚合,又能保留现场证据。
从迁移链定位循环跳转
状态机常见故障之一是两条条件彼此冲突。例如 Patrol 因看到目标切到 Chase,而 Chase 又立即因为距离过远切回 Patrol。角色表面可能只是原地抖动,但迁移日志会形成非常明显的重复模式。
下面是可能观察到的诊断日志示例:
FSM Patrol -> Chase | reason=TargetVisible
FSM Chase -> Patrol | reason=TargetTooFar
FSM Patrol -> Chase | reason=TargetVisible
FSM Chase -> Patrol | reason=TargetTooFar这段是诊断日志示例,不是前面程序的预期输出。出现这种模式时,应优先检查两个状态的切换条件是否重叠,再考虑加入迟滞区间、最短停留时间或更明确的条件优先级,而不是先去修改角色移动代码。
控制日志量而不是取消诊断
开发阶段可以记录全部状态迁移,发布版则需要控制数量。尤其是几十甚至上百个敌人同时运行时,如果每帧都输出状态信息,I/O 开销和日志噪声都可能超过日志本身的诊断价值。
更合理的策略是只把真正发生的迁移记录为正式日志,重复状态请求使用较低级别,并保持统一的 FSM 前缀、状态名和 reason 字段。这样出现误切换时,可以先从迁移链确认是哪条条件触发,再回到对应的感知数据或阈值定位根因。