游戏客户端架构 / 系统课时
播放序列帧动画
播放序列帧动画
序列帧动画的核心不是每次更新都换一帧,而是按累计时间决定何时推进。本课将实现一个可复用的动画播放器,支持播放速度、循环播放、单次播放、重置与结束状态,并用固定输入验证帧序列。
学习目标
- 使用累计时间稳定地推进动画帧
- 实现循环播放与单次播放两种结束策略
- 正确处理大帧间隔、重置和播放完成状态
用时间驱动帧索引
假设动画速度为每秒 fps 帧,则每帧持续时间为:
每次游戏循环把增量时间 deltaTime 加入累计器。当累计器达到一帧时长,就推进一帧并扣除对应时间。这里应使用 while 而不是 if,因为卡顿时一次更新可能跨过多帧。

实现动画播放器
下面的完整 C++ 示例用帧编号代替实际纹理区域。接入引擎时,只需把 currentFrame() 返回的索引映射到精灵帧列表。
#include <iostream>
#include <stdexcept>
enum class PlayMode {
Loop,
Once
};
class FrameAnimation {
public:
FrameAnimation(int frameCount, double framesPerSecond, PlayMode mode)
: frameCount_(frameCount), mode_(mode) {
if (frameCount <= 0 || framesPerSecond <= 0.0) {
throw std::invalid_argument("invalid animation settings");
}
frameDuration_ = 1.0 / framesPerSecond;
}
void update(double deltaTime) {
if (finished_ || deltaTime <= 0.0) {
return;
}
accumulator_ += deltaTime;
// 一次更新可能跨过多帧,因此持续消费累计时间。
while (accumulator_ >= frameDuration_ && !finished_) {
accumulator_ -= frameDuration_;
advanceOneFrame();
}
}
void reset() {
currentFrame_ = 0;
accumulator_ = 0.0;
finished_ = false;
}
int currentFrame() const {
return currentFrame_;
}
bool finished() const {
return finished_;
}
private:
void advanceOneFrame() {
if (currentFrame_ + 1 < frameCount_) {
++currentFrame_;
return;
}
if (mode_ == PlayMode::Loop) {
currentFrame_ = 0;
} else {
currentFrame_ = frameCount_ - 1;
finished_ = true;
}
}
int frameCount_;
double frameDuration_ = 0.0;
PlayMode mode_;
int currentFrame_ = 0;
double accumulator_ = 0.0;
bool finished_ = false;
};
void runDemo(PlayMode mode) {
FrameAnimation animation(4, 4.0, mode);
for (int step = 0; step < 5; ++step) {
animation.update(0.25);
std::cout << animation.currentFrame()
<< (animation.finished() ? " finished" : " playing")
<< "\n";
}
}
int main() {
std::cout << "loop\n";
runDemo(PlayMode::Loop);
std::cout << "once\n";
runDemo(PlayMode::Once);
}预期输出:
loop
1 playing
2 playing
3 playing
0 playing
1 playing
once
1 playing
2 playing
3 playing
3 finished
3 finished示例使用固定的 0.25 秒增量,因此输出确定。真实运行时的 <TIME> 会随设备帧率变化,但相同累计时间应得到相同动画进度。
循环与单次播放的差异
循环模式到达最后一帧后回到第 0 帧,适合待机、行走和持续特效。单次模式到达最后一帧后保持该画面,并把 finished 设为 true,适合攻击、受击和消失动画。
业务层不应通过“当前帧是不是最后一帧”判断动画完成,因为最后一帧在完成前也可能正在显示。应直接读取 finished(),再触发状态切换、对象回收或后续动作。
接入游戏循环
动画更新应放在逻辑更新阶段,并传入秒为单位的 deltaTime。渲染阶段只读取当前帧,不修改动画状态。这样即使一帧内发生多次渲染或渲染暂停,也不会破坏播放进度。
切换动画时要调用 reset(),否则新动画可能沿用旧的帧索引和累计时间。若角色状态频繁重复设置同一个动画,应先比较动画标识,避免每帧都重置而永远停在第一帧。
关键边界
当 deltaTime 很大时,while 能补进多帧,但极端卡顿可能导致大量循环。工程中可限制单次更新的最大补帧次数,或把过大的 deltaTime 截断为合理上限,避免动画更新拖慢主循环。
浮点累计可能产生微小误差,但一般不会影响视觉效果。需要严格同步时,可用整数微秒或固定时间步长记录动画进度。帧率、帧数必须大于零,构造阶段就应拒绝无效数据。
验收检查
循环动画应在最后一帧之后回到第 0 帧,并持续保持 finished == false。单次动画应只触发一次完成状态,之后停留在最后一帧。再用一次较大的 deltaTime 测试跨帧更新,确认播放器不会只推进一帧。
本课总结
- 序列帧动画应由累计时间驱动,而不是按游戏循环次数推进
- 使用
while消费累计时间,才能正确处理一次跨越多帧的情况 - 循环模式回到首帧,单次模式停在末帧并提供明确的完成状态
下一课预告
下一课将把动画播放器接入角色状态,根据移动、攻击等状态切换不同动画,并处理切换时的重置与优先级。