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

播放序列帧动画

播放序列帧动画

序列帧动画的核心不是每次更新都换一帧,而是按累计时间决定何时推进。本课将实现一个可复用的动画播放器,支持播放速度、循环播放、单次播放、重置与结束状态,并用固定输入验证帧序列。

学习目标

  • 使用累计时间稳定地推进动画帧
  • 实现循环播放与单次播放两种结束策略
  • 正确处理大帧间隔、重置和播放完成状态

用时间驱动帧索引

假设动画速度为每秒 fps 帧,则每帧持续时间为:

frameDuration=1/fpsframeDuration = 1 / fps

每次游戏循环把增量时间 deltaTime 加入累计器。当累计器达到一帧时长,就推进一帧并扣除对应时间。这里应使用 while 而不是 if,因为卡顿时一次更新可能跨过多帧。

序列帧动画的时间推进与结束分支

实现动画播放器

下面的完整 C++ 示例用帧编号代替实际纹理区域。接入引擎时,只需把 currentFrame() 返回的索引映射到精灵帧列表。

cpp
#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);
}

预期输出:

text
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 消费累计时间,才能正确处理一次跨越多帧的情况
  • 循环模式回到首帧,单次模式停在末帧并提供明确的完成状态

下一课预告

下一课将把动画播放器接入角色状态,根据移动、攻击等状态切换不同动画,并处理切换时的重置与优先级。

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

目录与阅读设置

阅读设置

17

记录一个想法

播放序列帧动画

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

登录哪都通