游戏客户端架构 / 系统课时
统计运行帧率
统计运行帧率
本课会把主循环中的时间数据整理成可观测指标,最终得到帧率、平均帧耗时、最大帧耗时和更新耗时。完成后,你可以用统一的统计窗口发现卡顿,而不是只凭画面感觉判断性能。
学习目标
- 理解 FPS、帧耗时与更新耗时之间的关系
- 使用固定统计窗口汇总每帧数据
- 通过平均值和最大值初步定位性能波动
用一组指标描述每一帧
FPS 表示一秒完成了多少帧,适合观察整体流畅度;帧耗时表示完成一帧用了多少毫秒,更适合和预算比较。以 60 FPS 为目标时,单帧预算约为 16.67 毫秒,但平均值达标并不代表没有偶发卡顿。
更新耗时只统计游戏逻辑阶段,例如输入、物理、动画和脚本。它不包含渲染与等待时间,因此能帮助你判断问题来自逻辑更新,还是来自渲染、同步或帧率限制。
统计时不要每帧直接打印日志。频繁输出会反过来干扰性能,应先在内存中累计约一秒的数据,再集中生成一次报告。
实现帧率统计器
下面的完整 C++17 示例模拟更新与渲染工作,并按一秒窗口输出统计结果。实际引擎中,只需把两段 sleep_for 替换为真实的 Update 和 Render 调用。
#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);
}
}预期输出如下。调度误差会使实际数值略有波动,因此用占位值表示动态结果。
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 适合看整体吞吐,帧耗时更适合和单帧预算比较
- 平均值用于判断持续压力,最大值用于发现偶发卡顿
- 统计应按时间窗口汇总,并避免每帧打印日志
下一课预告
下一课将把统计数据接入主循环调试信息,并继续分析输入事件在帧边界中的采集方式。