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

管理动画片段

管理动画片段

动画片段把一组精灵帧、每帧时长和循环规则封装成可复用资源。本课将实现一个最小 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=0

time=0.4 等于片段总时长,因此循环片段回到第 0 帧。实际运行时浮点数可能存在微小误差,生产代码可使用整数毫秒或帧计数降低边界抖动。

播放时需要处理的边界

空帧列表应在资源加载阶段直接判错,否则播放时无法返回有效帧。单帧片段仍然可以循环,常用于静态待机图;非循环片段播放结束后则应保持最后一帧,并由上层逻辑决定何时切换状态。

不要把播放时间写进 AnimationClip。片段是共享资源,播放时间属于角色自己的 Animator。如果两者混在一起,多个角色引用同一片段时会共享进度,出现所有角色同步跳帧的问题。

验收动画片段

验证时至少检查三个场景:时间位于第一帧、中间帧和总时长边界;再分别测试循环与非循环模式。若资源来自外部文件,还应在加载时拒绝负时长、零时长和空帧列表。

本课总结

  • 动画片段负责保存帧序列和播放参数,不保存角色的实时播放进度
  • 逐帧时长适合不均匀节奏,循环片段可通过总时长取模定位当前帧
  • 空帧、非法时长和播放结束行为应在接口层明确处理

下一课预告

下一课将把动画片段接入角色状态机,根据待机、移动和受击状态切换对应动画,并处理切换优先级与播放重置。

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

目录与阅读设置

阅读设置

17

记录一个想法

管理动画片段

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

登录哪都通