Files
zeling_v2/Assets/_Game/Scripts/Enemies/AIBrain/PerceptionStateMachine.cs
T
joywayerandClaude Opus 4.8 6c27993e09 feat(ai): 敌人感知↔状态模型——待机/警觉/追击/巡逻 + 可复用感知状态机
感知门面 EnemyBase.InChaseZone(追逐/aggro)/InVisionZone(视野/los,缺省回退aggro),纯查询;
转换逻辑归 AI 层: 新增可复用 PerceptionStateMachine(统一规则,HasAlert/视野缺省自动降级);
规则: 未发现进视野→警觉, 进追逐→追击(委托能力), 追击脱离视野→巡逻(永不回警觉,再进视野再警觉).
EnemyStatsSO.HasAlertState 勾选项; ContactChaseAbility 改纯执行器(退出由AI中断); E001 用可复用件.
PlayMode 验证四态转换全通过.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-07-09 15:10:39 +08:00

78 lines
3.7 KiB
C#

using System;
using BaseGames.AI;
namespace BaseGames.Enemies
{
/// <summary>
/// 可复用的"待机/警觉/追击/巡逻"感知状态机(统一规则,见 spec《敌人感知↔状态》)。
/// 职责边界:**状态转换逻辑在 AI 层(本类)**;感知系统只回答 InChaseZone/InVisionZone。
/// 规则:
/// 待机/巡逻: 在追逐区→追击(优先); 否则 有警觉且在视野→警觉; 否则保持。
/// 警觉: 在追逐区→追击; 否则 脱离视野→R; 否则保持警觉。
/// 追击: 委托能力; 脱离视野→R(永不回警觉)。
/// 缺省自动降级:无警觉(HasAlert=false)→警觉分支不触发;无视野槽→维持退化用追逐区。
/// </summary>
public static class PerceptionStateMachine
{
public sealed class Config
{
public string Idle = "Idle";
public string Patrol = "Patrol";
public string Alert = "Alert";
public string Chase = "Chase";
public string Death = "Death";
public string Entry = "Idle"; // 初始态
public string Rest = "Patrol"; // R:降级(退出追击/警觉丢失)回到的静止态
public string ChaseAbilityId; // 追击委托的能力 id(进入追击即触发;退出由 OnChaseExit 中断)
public Action<IAiContext> OnIdleEnter;
public Action<IAiContext> OnPatrolEnter;
public Action<IAiContext> OnPatrolTick;
public Action<IAiContext> OnAlertEnter;
public Action<IAiContext> OnChaseEnter;
public Action<IAiContext> OnChaseExit;
public Action<IAiContext> OnDeathEnter;
}
public static void Add(BrainBuilder b, Config c)
{
b.Entry(c.Entry);
b.Global().To(c.Death).OnEvent(AiSignal.Died); // 受击致死 → 死亡(全局最高优先)
// 待机 / 巡逻:未发现态,同样的升级转换(追逐优先、其次警觉)
AddUndiscovered(b.State(c.Idle).OnEnter(x => c.OnIdleEnter?.Invoke(x)), c);
AddUndiscovered(
b.State(c.Patrol)
.OnEnter(x => c.OnPatrolEnter?.Invoke(x))
.Tick(x => c.OnPatrolTick?.Invoke(x)),
c);
// 警觉(仅升级路径出现):进追逐区→追击;脱离视野→R;在视野内则保持(无转出)
b.State(c.Alert)
.OnEnter(x => c.OnAlertEnter?.Invoke(x))
.To(c.Chase).When(x => x.Sensor.InChaseZone(), "InChaseZone")
.To(c.Rest).When(x => !x.Sensor.InVisionZone(), "leftVision");
// 追击:委托能力实现移动/伤害;脱离视野 → R(永不回警觉);退出时中断追击能力
b.State(c.Chase)
.OnEnter(x =>
{
c.OnChaseEnter?.Invoke(x);
if (!string.IsNullOrEmpty(c.ChaseAbilityId)) x.Combat.UseAbility(c.ChaseAbilityId);
})
.OnExit(x => c.OnChaseExit?.Invoke(x))
.To(c.Rest).When(x => !x.Sensor.InVisionZone(), "leftVision");
b.State(c.Death).OnEnter(x => c.OnDeathEnter?.Invoke(x));
}
// 未发现态(Idle/Patrol)升级:在追逐区→追击(优先);否则 有警觉且在视野→警觉
static void AddUndiscovered(BrainBuilder.StateBuilder sb, Config c)
{
sb.To(c.Chase).When(x => x.Sensor.InChaseZone(), "InChaseZone")
.To(c.Alert).When(x => HasAlert(x) && x.Sensor.InVisionZone(), "InVision+HasAlert");
}
static bool HasAlert(IAiContext x) => x is IEnemyActor a && a.HasAlertState;
}
}