游戏客户端架构 / 系统课时
实现角色控制
实现角色控制
本课把输入、动画、移动与碰撞组件串成一条可运行的角色控制链路。完成后,角色能够响应方向输入、阻止越界移动,并依据静止或移动状态切换动画。
学习目标
- 理解角色控制器与输入、变换、碰撞、动画组件的职责边界
- 按固定顺序处理输入、移动、碰撞修正和动画更新
- 使用最小可运行示例验证移动结果与动画状态
拆分角色控制职责
角色控制不应全部写进一个巨大的 update 方法。输入组件只保存当前按键状态,控制器负责把输入转换为速度,碰撞组件限制最终位置,动画组件根据运动结果选择播放状态。

这条链路的关键是“先计算候选结果,再提交最终结果”。如果先修改位置、再检测碰撞,角色可能短暂进入障碍物;如果动画直接读取按键,角色被墙挡住时仍可能播放奔跑动画。
确定每帧更新顺序
一次角色更新可以按以下顺序执行:
- 读取输入并归一化方向,避免斜向移动比水平移动更快。
- 根据速度和增量时间计算候选位置。
- 让碰撞组件把候选位置限制在可移动区域。
- 提交最终位置,并根据实际位移切换动画。
移动公式为 位移 = 方向 × 速度 × deltaTime。其中 deltaTime 使用秒,速度单位可约定为“世界单位每秒”。
Tips:控制器计算的是“意图”,碰撞组件给出的是“允许发生的结果”。把两者分开后,后续增加击退、冰面或冲刺效果会更容易。
完成最小可运行实现
下面的 C++17 示例用矩形边界模拟碰撞区域,并连续执行四帧输入。代码可独立编译运行。
cpp
#include <algorithm>
#include <cmath>
#include <iomanip>
#include <iostream>
#include <string>
#include <vector>
struct Vec2 {
float x = 0.0f;
float y = 0.0f;
};
struct InputState {
bool left = false;
bool right = false;
bool up = false;
bool down = false;
};
struct TransformComponent {
Vec2 position{1.0f, 1.0f};
};
struct ColliderComponent {
float minX = 0.0f;
float minY = 0.0f;
float maxX = 3.0f;
float maxY = 3.0f;
Vec2 resolve(const Vec2& candidate) const {
return {
std::clamp(candidate.x, minX, maxX),
std::clamp(candidate.y, minY, maxY)
};
}
};
struct AnimationComponent {
std::string state = "Idle";
void update(const Vec2& actualMove) {
const float lengthSquared =
actualMove.x * actualMove.x + actualMove.y * actualMove.y;
state = lengthSquared > 0.000001f ? "Run" : "Idle";
}
};
class PlayerController {
public:
explicit PlayerController(float speed) : speed_(speed) {}
void update(
const InputState& input,
float deltaTime,
TransformComponent& transform,
const ColliderComponent& collider,
AnimationComponent& animation
) const {
Vec2 direction{
static_cast<float>(input.right) - static_cast<float>(input.left),
static_cast<float>(input.down) - static_cast<float>(input.up)
};
const float length =
std::sqrt(direction.x * direction.x + direction.y * direction.y);
if (length > 0.0f) {
direction.x /= length;
direction.y /= length;
}
const Vec2 oldPosition = transform.position;
const Vec2 candidate{
oldPosition.x + direction.x * speed_ * deltaTime,
oldPosition.y + direction.y * speed_ * deltaTime
};
// 碰撞修正后再提交位置,动画读取实际位移而不是原始按键。
transform.position = collider.resolve(candidate);
const Vec2 actualMove{
transform.position.x - oldPosition.x,
transform.position.y - oldPosition.y
};
animation.update(actualMove);
}
private:
float speed_;
};
int main() {
TransformComponent transform;
ColliderComponent collider;
AnimationComponent animation;
PlayerController controller(2.0f);
const std::vector<InputState> frames{
{false, true, false, false},
{false, true, false, true},
{false, true, false, false},
{false, false, false, false}
};
std::cout << std::fixed << std::setprecision(2);
for (std::size_t i = 0; i < frames.size(); ++i) {
controller.update(
frames[i], 1.0f, transform, collider, animation
);
std::cout << "frame=" << i + 1
<< " position=(" << transform.position.x
<< ", " << transform.position.y << ")"
<< " animation=" << animation.state << '\n';
}
}预期输出:
text
frame=1 position=(3.00, 1.00) animation=Run
frame=2 position=(3.00, 2.41) animation=Run
frame=3 position=(3.00, 2.41) animation=Idle
frame=4 position=(3.00, 2.41) animation=Idle第三帧虽然仍按住右键,但角色已经位于右边界,实际位置没有变化,因此动画正确回到 Idle。这正是动画读取“实际位移”而不是“输入意图”的价值。
接入游戏循环并验收
在真实引擎中,应让输入系统先刷新状态,再调用角色控制器,最后由渲染系统读取已经修正的变换。若物理系统使用固定时间步长,角色移动也应放在固定更新阶段,避免帧率变化影响速度。
验收时至少检查三种情况:单方向移动速度稳定;同时按两个方向时速度不增加;贴住边界继续输入时位置不穿透且动画回到静止。实际调试日志中的时间、对象 ID 或坐标精度可能不同。
本课总结
- 角色控制器负责转换意图,碰撞组件负责决定最终可达位置
- 正确顺序是输入、候选移动、碰撞修正、动画更新
- 动画应依据实际位移切换,避免被阻挡时仍播放奔跑
下一课预告
下一课将用事件与组件实现目标判定、得分累计和失败条件,把角色操作扩展为可完成、可失败的核心玩法闭环。
按自己的节奏,确认真正理解。