游戏客户端架构 / 系统课时
管理动画片段
管理动画片段
动画片段把一组精灵帧、每帧时长和循环规则封装成可复用资源。本课将实现一个最小 AnimationClip,并验证它能按时间正确选择当前帧,为后续动画状态切换提供稳定的数据基础。
学习目标
- 理解动画片段需要保存的核心数据
- 能用 C++ 封装帧序列、时长与循环参数
- 能验证循环播放和非循环播放的边界行为
动画片段封装什么
动画片段不是“正在播放的动画”,而是一份只读配置。它通常保存片段名称、帧列表、每帧持续时间、总时长以及是否循环。真正的播放进度应由播放器或动画组件单独维护,这样多个角色才能共享同一片段而互不影响。

帧持续时间应存放在帧自身或片段的统一帧率配置中。逐帧时长更灵活,适合攻击停顿、受击闪烁等节奏不均匀的动画;统一帧率更简单,适合规则循环动画。
实现 AnimationClip
下面的示例使用逐帧时长,并提供 frameAtTime 方法。循环片段通过取模回到开头,非循环片段在超过总时长后停留在最后一帧。
cpp
#include <algorithm>
#include <cmath>
#include <iomanip>
#include <iostream>
#include <stdexcept>
#include <string>
#include <utility>
#include <vector>
struct AnimationFrame {
int spriteIndex;
float durationSeconds;
};
class AnimationClip {
public:
AnimationClip(std::string name,
std::vector<AnimationFrame> frames,
bool loop)
: name_(std::move(name)), frames_(std::move(frames)), loop_(loop) {
for (const auto& frame : frames_) {
if (frame.durationSeconds <= 0.0f) {
throw std::invalid_argument("frame duration must be positive");
}
totalDuration_ += frame.durationSeconds;
}
}
const AnimationFrame& frameAtTime(float timeSeconds) const {
if (frames_.empty()) {
throw std::runtime_error("animation clip has no frames");
}
const float safeTime = std::max(0.0f, timeSeconds);
if (!loop_ && safeTime >= totalDuration_) {
return frames_.back();
}
const float localTime = loop_
? std::fmod(safeTime, totalDuration_)
: safeTime;
float accumulated = 0.0f;
for (const auto& frame : frames_) {
accumulated += frame.durationSeconds;
if (localTime < accumulated) {
return frame;
}
}
return frames_.back();
}
float totalDuration() const {
return totalDuration_;
}
private:
std::string name_;
std::vector<AnimationFrame> frames_;
bool loop_;
float totalDuration_ = 0.0f;
};
int main() {
AnimationClip walk(
"walk",
{{0, 0.1f}, {1, 0.1f}, {2, 0.1f}, {3, 0.1f}},
true
);
std::cout << std::fixed << std::setprecision(1);
std::cout << "duration=" << walk.totalDuration() << "\n";
for (float time : {0.0f, 0.1f, 0.2f, 0.4f}) {
std::cout << "time=" << time
<< ", frame=" << walk.frameAtTime(time).spriteIndex
<< "\n";
}
}运行命令:
bash
g++ -std=c++17 animation_clip.cpp -o animation_clip
./animation_clip预期输出:
text
duration=0.4
time=0.0, frame=0
time=0.1, frame=1
time=0.2, frame=2
time=0.4, frame=0time=0.4 等于片段总时长,因此循环片段回到第 0 帧。实际运行时浮点数可能存在微小误差,生产代码可使用整数毫秒或帧计数降低边界抖动。
播放时需要处理的边界
空帧列表应在资源加载阶段直接判错,否则播放时无法返回有效帧。单帧片段仍然可以循环,常用于静态待机图;非循环片段播放结束后则应保持最后一帧,并由上层逻辑决定何时切换状态。
不要把播放时间写进 AnimationClip。片段是共享资源,播放时间属于角色自己的 Animator。如果两者混在一起,多个角色引用同一片段时会共享进度,出现所有角色同步跳帧的问题。
验收动画片段
验证时至少检查三个场景:时间位于第一帧、中间帧和总时长边界;再分别测试循环与非循环模式。若资源来自外部文件,还应在加载时拒绝负时长、零时长和空帧列表。
本课总结
- 动画片段负责保存帧序列和播放参数,不保存角色的实时播放进度
- 逐帧时长适合不均匀节奏,循环片段可通过总时长取模定位当前帧
- 空帧、非法时长和播放结束行为应在接口层明确处理
下一课预告
下一课将把动画片段接入角色状态机,根据待机、移动和受击状态切换对应动画,并处理切换优先级与播放重置。
按自己的节奏,确认真正理解。