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

统计运行帧率

统计运行帧率

本课会把主循环中的时间数据整理成可观测指标,最终得到帧率、平均帧耗时、最大帧耗时和更新耗时。完成后,你可以用统一的统计窗口发现卡顿,而不是只凭画面感觉判断性能。

学习目标

  • 理解 FPS、帧耗时与更新耗时之间的关系
  • 使用固定统计窗口汇总每帧数据
  • 通过平均值和最大值初步定位性能波动

用一组指标描述每一帧

FPS 表示一秒完成了多少帧,适合观察整体流畅度;帧耗时表示完成一帧用了多少毫秒,更适合和预算比较。以 60 FPS 为目标时,单帧预算约为 16.67 毫秒,但平均值达标并不代表没有偶发卡顿。

更新耗时只统计游戏逻辑阶段,例如输入、物理、动画和脚本。它不包含渲染与等待时间,因此能帮助你判断问题来自逻辑更新,还是来自渲染、同步或帧率限制。

统计时不要每帧直接打印日志。频繁输出会反过来干扰性能,应先在内存中累计约一秒的数据,再集中生成一次报告。

实现帧率统计器

下面的完整 C++17 示例模拟更新与渲染工作,并按一秒窗口输出统计结果。实际引擎中,只需把两段 sleep_for 替换为真实的 Update 和 Render 调用。

cpp
#include <algorithm>
#include <chrono>
#include <iomanip>
#include <iostream>
#include <thread>

class FrameStats {
public:
    void addFrame(double frameMs, double updateMs) {
        ++frameCount_;
        elapsedMs_ += frameMs;
        frameTotalMs_ += frameMs;
        updateTotalMs_ += updateMs;
        maxFrameMs_ = std::max(maxFrameMs_, frameMs);

        // 约一秒输出一次,避免日志本身影响主循环。
        if (elapsedMs_ >= 1000.0) {
            printReport();
            reset();
        }
    }

private:
    void printReport() const {
        const double fps = frameCount_ * 1000.0 / elapsedMs_;
        const double avgFrameMs = frameTotalMs_ / frameCount_;
        const double avgUpdateMs = updateTotalMs_ / frameCount_;

        std::cout << std::fixed << std::setprecision(2)
                  << "FPS=" << fps
                  << " avgFrame=" << avgFrameMs << "ms"
                  << " maxFrame=" << maxFrameMs_ << "ms"
                  << " avgUpdate=" << avgUpdateMs << "ms\n";
    }

    void reset() {
        frameCount_ = 0;
        elapsedMs_ = 0.0;
        frameTotalMs_ = 0.0;
        updateTotalMs_ = 0.0;
        maxFrameMs_ = 0.0;
    }

    int frameCount_ = 0;
    double elapsedMs_ = 0.0;
    double frameTotalMs_ = 0.0;
    double updateTotalMs_ = 0.0;
    double maxFrameMs_ = 0.0;
};

int main() {
    using Clock = std::chrono::steady_clock;
    constexpr std::chrono::duration<double, std::milli> targetFrame(16.67);
    FrameStats stats;

    for (int frame = 0; frame < 180; ++frame) {
        const auto frameStart = Clock::now();

        // 模拟逻辑更新与渲染,分别统计更新阶段和完整帧。
        std::this_thread::sleep_for(std::chrono::milliseconds(2));
        const auto updateEnd = Clock::now();
        std::this_thread::sleep_for(std::chrono::milliseconds(4));

        const auto workEnd = Clock::now();
        const auto workTime = workEnd - frameStart;
        if (workTime < targetFrame) {
            std::this_thread::sleep_for(targetFrame - workTime);
        }

        const auto frameEnd = Clock::now();
        const double frameMs =
            std::chrono::duration<double, std::milli>(frameEnd - frameStart).count();
        const double updateMs =
            std::chrono::duration<double, std::milli>(updateEnd - frameStart).count();
        stats.addFrame(frameMs, updateMs);
    }
}

预期输出如下。调度误差会使实际数值略有波动,因此用占位值表示动态结果。

text
FPS=<FPS> avgFrame=<FRAME_MS>ms maxFrame=<MAX_FRAME_MS>ms avgUpdate=<UPDATE_MS>ms
FPS=<FPS> avgFrame=<FRAME_MS>ms maxFrame=<MAX_FRAME_MS>ms avgUpdate=<UPDATE_MS>ms

读取统计结果

先看平均帧耗时是否超过目标预算,再看最大帧耗时是否明显偏高。如果平均值稳定而最大值偶尔突增,通常说明某一帧发生了资源加载、日志阻塞、垃圾回收或系统调度抖动。

随后比较更新耗时与完整帧耗时。如果更新耗时接近完整帧耗时,应继续细分逻辑阶段;如果更新耗时很低但完整帧仍然很高,应检查渲染、垂直同步、帧率限制或 GPU 等待。

发布版本中可以把统计结果写入环形缓冲区,并按需展示在调试面板。不要只保存平均 FPS,至少同时保留平均帧耗时和最大帧耗时。

常见统计偏差

使用系统墙上时钟可能受时间校准影响,主循环计时应选择单调递增的 steady_clock。统计窗口也不应简单假设固定帧数,因为帧率下降时,同样的帧数会覆盖更长时间。

帧率限制阶段是否计入帧耗时要保持一致。本课把等待时间计入完整帧,因此得到的是玩家实际感受到的帧间隔;更新耗时则排除等待,便于分析 CPU 逻辑成本。

本课总结

  • FPS 适合看整体吞吐,帧耗时更适合和单帧预算比较
  • 平均值用于判断持续压力,最大值用于发现偶发卡顿
  • 统计应按时间窗口汇总,并避免每帧打印日志

下一课预告

下一课将把统计数据接入主循环调试信息,并继续分析输入事件在帧边界中的采集方式。

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

目录与阅读设置

阅读设置

17

记录一个想法

统计运行帧率

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

登录哪都通