游戏客户端架构 / 系统课时
让敌人与玩家共享组件能力
让敌人与玩家共享组件能力
玩家和敌人都需要移动、受伤与攻击,却不必使用相同的输入来源、数值配置或运行状态。本课提炼共同的能力接口,让玩家输入和追击 AI 驱动同一套组件实现,再用两回合模拟验证状态按对象独立保存。
学习目标
- 区分共享组件实现与共享组件实例,避免生命值、位置等状态串用。
- 定义控制意图和受伤能力契约,使玩家与敌人可以替换控制来源。
- 装配两种角色并验证相同能力在不同配置下正确工作。
复用能力契约,不复用角色身份
按角色类型复制出 PlayerHealth 和 EnemyHealth,通常只会让扣血、死亡判定和测试逻辑重复。更稳定的边界是 HealthComponent.receive_damage(amount)、MovementComponent.apply(direction) 和 AttackComponent.hit(target):它们只描述能力,不检查调用者是否为玩家。
攻击目标只需要满足 DamageReceiver 契约,拥有接收伤害的方法,而不必暴露具体角色类。不同对象可以共享这些类的实现,但每个对象都必须有自己的 hp、position 和其他会变化的实例状态。配置里的基础生命值、攻击力可以相同,当前生命值仍不能混用。
把控制来源统一成动作意图
玩家控制器读取操作指令,敌人控制器依据位置作出追击或攻击决定;两者都交付 Intent(move, attack)。接下来的移动和攻击组件不区分指令来自键盘、手柄还是 AI,因此不需要在能力代码里写 if player 或 if enemy 分支。

关键是把控制策略和执行能力分开:增加巡逻 AI、网络远程输入或录制回放时,替换的是产生 Intent 的控制器,不是重新实现生命值和移动组件。
装配两种角色并运行两回合
下面的 Python 3.10+ 示例把位置简化为一维整数、攻击距离设为 1。每回合依次执行玩家和敌人的指令,忽略复杂碰撞、动画和冷却;重点是展示同一组件类如何装配成两个状态独立的对象。
from dataclasses import dataclass
from typing import Protocol
@dataclass(frozen=True)
class Intent:
move: int = 0
attack: bool = False
class Controller(Protocol):
def decide(self, own_pos: int, target_pos: int) -> Intent: ...
class DamageReceiver(Protocol):
def receive_damage(self, amount: int) -> None: ...
class PlayerController:
def __init__(self, commands: list[Intent]):
self.commands = iter(commands)
def decide(self, own_pos: int, target_pos: int) -> Intent:
# 玩家控制器只提供指令,不参与能力实现
return next(self.commands, Intent())
class ChaseAIController:
def decide(self, own_pos: int, target_pos: int) -> Intent:
delta = target_pos - own_pos
if abs(delta) > 1:
return Intent(move=1 if delta > 0 else -1)
return Intent(attack=True)
@dataclass
class MovementComponent:
position: int
def apply(self, direction: int) -> None:
self.position += max(-1, min(1, direction))
@dataclass
class HealthComponent:
hp: int
def receive_damage(self, amount: int) -> None:
self.hp = max(0, self.hp - max(0, amount))
@dataclass(frozen=True)
class AttackComponent:
power: int
def hit(self, target: DamageReceiver) -> None:
target.receive_damage(self.power)
class Actor:
def __init__(self, hp: int, position: int, power: int, controller: Controller):
# 每次装配创建独立的可变状态实例
self.health = HealthComponent(hp)
self.movement = MovementComponent(position)
self.attack = AttackComponent(power)
self.controller = controller
def step(self, target: "Actor") -> None:
if self.health.hp == 0:
return
intent = self.controller.decide(
self.movement.position, target.movement.position
)
self.movement.apply(intent.move)
if intent.attack and abs(self.movement.position - target.movement.position) <= 1:
self.attack.hit(target.health)
player = Actor(20, 0, 4, PlayerController([Intent(move=1), Intent(attack=True)]))
enemy = Actor(12, 3, 3, ChaseAIController())
player.step(enemy)
enemy.step(player)
print(f"回合1 玩家位置={player.movement.position} 敌人位置={enemy.movement.position}")
player.step(enemy)
enemy.step(player)
print(f"回合2 玩家HP={player.health.hp} 敌人HP={enemy.health.hp}")
print(f"同类实现={type(player.health) is type(enemy.health)} 独立状态={player.health is not enemy.health}")预期输出:
回合1 玩家位置=1 敌人位置=2
回合2 玩家HP=17 敌人HP=8
同类实现=True 独立状态=True第一回合玩家前进一步,敌人 AI 向玩家靠近一步。第二回合双方已相距一个单位,玩家造成 4 点伤害,敌人造成 3 点伤害。最后一行通过类身份和对象身份检查证明:双方用的是同一个 HealthComponent 实现,但不是同一个生命组件实例。
识别状态串用和能力过度绑定
如果把 hp、位置或攻击冷却放进共享的可变单例,玩家受伤可能改变敌人的状态。即使两个角色使用同一份只读配置,也应在出生时为各自建立运行状态;拥有内部记忆的 AI 控制器还要分别保留目标、计时器与黑板。
检验复用是否成功,可以把敌人控制器替换为另一种实现,确认移动、受伤与攻击组件不需要修改;再单独伤害玩家,确认敌人生命值不变。示例把攻击距离检查放在角色协调层,真实项目可进一步移入独立命中结算服务,但不要因此把玩家身份判断重新塞回通用能力组件。