游戏客户端架构 / 系统课时
事件触发逻辑该放动画里吗
事件触发逻辑该放动画里吗
攻击命中、脚步声和特效都可能对齐动画时间点,但如果扣血、冷却和状态切换直接由动画通知决定,打断、跳帧或换动画资源就可能改变战斗结果。本课把动画提示、动作状态与玩法裁决拆开,并用最小示例验证其边界。
学习目标
- 分清动画通知、角色动作状态和 Gameplay 逻辑分别负责什么。
- 设计能拦截过期通知、重复结算的事件路径。
- 在不运行动画播放器的情况下验证命中逻辑。
时机提示不等于玩法裁决
动画通知(Animation Notify/Event)擅长回答“画面播放到哪里”:脚着地时提示播放音效、刀锋挥出时提示拖尾特效、换弹动作到达某帧时提示表现更新。它是资源时间轴上的标记,不应成为伤害、弹药、冷却或胜负结果的唯一依据。
角色动作状态保存“现在允许做什么”,例如动作实例 ID、当前阶段、是否已处理本次命中。独立的 Gameplay 模块负责校验条件、查询碰撞、扣除资源和提交结果;表现系统消费校验通过的提示,播放音效与特效。
| 事件或决策 | 推荐归属 | 原因 |
|---|---|---|
| 脚步声、武器拖尾 | 动画提示 → 表现层 | 依赖可见动作相位 |
| 攻击是否进入生效窗口 | Gameplay 动作时钟与阶段 | 不能由漏发的通知决定 |
| 命中、扣血、冷却 | Gameplay | 需要一致性、幂等和独立测试 |
| UI 命中反馈 | Gameplay 结果 → 表现层 | 反馈应反映已确认的结果 |
为通知设置校验边界
推荐从角色输入或 AI 指令创建新的动作实例,再由 Gameplay 推进 Windup → Active → Recovery。动画播放器根据当前状态播放片段并发出携带 actionId 的提示,接收方先检查实例、阶段和消费情况,最后才分发给表现层。命中检测则由 Gameplay 在有效窗口中独立执行。

这里的 actionId 是每次动作启动时变化的实例标识,不是动画片段名称。角色从攻击 A 被打断并进入攻击 B 后,即便 A 的异步通知迟到,也不能落到 B 上。若一次动作可能击中多个目标,去重键还需包含目标 ID 或具体命中段编号,而不能只存一个布尔值。
用独立逻辑验证命中
下面用 Python 标准库模拟一个单目标、单命中段动作。on_anim_cue 只能返回表现提示;resolve_hit 才能在有效窗口内改变目标 HP。示例中的 target_in_range 代表已经完成的碰撞查询结果,真实项目应改由引擎空间查询提供。
from dataclasses import dataclass
@dataclass
class Action:
action_id: int
phase: str = "Windup"
hit_checked: bool = False
class Combat:
def __init__(self):
self.current = None
self.target_hp = 100
def start(self, action_id):
# 每次动作使用新 ID,旧通知不能复用当前状态
self.current = Action(action_id)
print(f"战斗:开始动作 {action_id}")
def enter_active(self):
self.current.phase = "Active"
def on_anim_cue(self, action_id):
action = self.current
if action is None or action.action_id != action_id:
return "丢弃:过期动作通知"
if action.phase != "Active":
return "丢弃:阶段不是 Active"
# 通知只负责表现,绝不直接修改目标 HP
return f"表现:动作 {action_id} 播放挥击音效"
def resolve_hit(self, target_in_range):
action = self.current
if action is None or action.phase != "Active":
return "玩法:不在生效窗口"
if action.hit_checked:
return "玩法:本动作已结算,忽略重复请求"
# 单目标、单次命中段:先标记已结算,再改变数值
action.hit_checked = True
if target_in_range:
self.target_hp -= 20
return f"玩法:命中一次,目标 HP={self.target_hp}"
return "玩法:未命中"
combat = Combat()
combat.start(101)
print(combat.on_anim_cue(101))
combat.enter_active()
print(combat.on_anim_cue(101))
print(combat.resolve_hit(target_in_range=True))
print(combat.resolve_hit(target_in_range=True))
combat.start(102)
print(combat.on_anim_cue(101))预期输出:
战斗:开始动作 101
丢弃:阶段不是 Active
表现:动作 101 播放挥击音效
玩法:命中一次,目标 HP=80
玩法:本动作已结算,忽略重复请求
战斗:开始动作 102
丢弃:过期动作通知注意命中只在调用 resolve_hit 时发生;删掉所有动画通知调用,玩法命中仍可按状态与碰撞结果执行。由此可以给 Gameplay 写无需加载模型、动画片段的单元测试。
打断和跨帧时怎样处理
播放速度、混合过渡、低帧率和网络同步会使通知延后、被跳过或重复。因此,动作阶段应以同一套 Gameplay 时钟、动作实例和权威状态为依据,不要让“收到某一帧通知”成为唯一状态转移条件。帧推进跨过时间窗时,玩法模块应检测区间是否相交,并按照设计执行一次判定。
实战验收可覆盖三类场景:通知在生效前到达必须被拦截;同一个命中段被处理两次不能重复扣血;动作切换后旧 actionId 事件不能触发新动作表现。联网项目还需由权威端裁决伤害,客户端的动画通知只负责本地预测表现及结果对齐。
判断代码归属时,用一个简单标准:如果禁用动画播放器后这条规则仍必须成立,它就应属于 Gameplay,而不是动画资源中的事件脚本。