游戏客户端架构 / 系统课时

实现角色控制

实现角色控制

本课把输入、动画、移动与碰撞组件串成一条可运行的角色控制链路。完成后,角色能够响应方向输入、阻止越界移动,并依据静止或移动状态切换动画。

学习目标

  • 理解角色控制器与输入、变换、碰撞、动画组件的职责边界
  • 按固定顺序处理输入、移动、碰撞修正和动画更新
  • 使用最小可运行示例验证移动结果与动画状态

拆分角色控制职责

角色控制不应全部写进一个巨大的 update 方法。输入组件只保存当前按键状态,控制器负责把输入转换为速度,碰撞组件限制最终位置,动画组件根据运动结果选择播放状态。

角色控制组件协作图

这条链路的关键是“先计算候选结果,再提交最终结果”。如果先修改位置、再检测碰撞,角色可能短暂进入障碍物;如果动画直接读取按键,角色被墙挡住时仍可能播放奔跑动画。

确定每帧更新顺序

一次角色更新可以按以下顺序执行:

  1. 读取输入并归一化方向,避免斜向移动比水平移动更快。
  2. 根据速度和增量时间计算候选位置。
  3. 让碰撞组件把候选位置限制在可移动区域。
  4. 提交最终位置,并根据实际位移切换动画。

移动公式为 位移 = 方向 × 速度 × 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 或坐标精度可能不同。

本课总结

  • 角色控制器负责转换意图,碰撞组件负责决定最终可达位置
  • 正确顺序是输入、候选移动、碰撞修正、动画更新
  • 动画应依据实际位移切换,避免被阻挡时仍播放奔跑

下一课预告

下一课将用事件与组件实现目标判定、得分累计和失败条件,把角色操作扩展为可完成、可失败的核心玩法闭环。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

实现角色控制

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通