Web 图形与 3D / 系统课时
分开记录加载尖峰和稳态耗时
分开记录加载尖峰和稳态耗时
同一场景可能只在首次渲染或切换时卡一下,也可能在漫游过程中持续掉帧。本篇把首帧、首次交互、连续漫游和场景切换拆成独立采样窗口,记录帧间隔分布与关键事件耗时,避免用一个平均 FPS 掩盖不同问题。
学习目标
- 为四类操作定义可重复的采样起止条件。
- 用
requestAnimationFrame记录帧间隔,并计算 p50、p95、p99 与慢帧占比。 - 区分初始化尖峰、交互阻塞和持续渲染压力,形成可比较的性能记录。
划定四个不重叠的观测窗口
先固定浏览器、窗口尺寸、设备、电源模式、像素比和场景资产。以 60 Hz 屏幕为例,单帧预算约 16.7 ms;33.3 ms 以上的帧间隔可作为明显卡顿的观察阈值,不等于所有高刷新率设备的合格线。
| 阶段 | 触发与采样窗口 | 重点记录 |
|---|---|---|
| 首帧与启动期 | 刷新页面后,从初始化计时到首次 render() 返回;另外采前 120 个帧间隔 |
首次提交耗时、启动期 p95、最大值 |
| 首次交互 | 启动采样结束后,首次点击画布,采之后 120 帧 | 首次输入后的尖峰、慢帧占比 |
| 连续漫游 | 沿相同相机运动轨迹,连续采 300 帧 | p50、p95、p99、超 33.3 ms 比例 |
| 场景切换 | 点击切换按钮,包含同步创建与后续 120 帧 | 切换同步耗时、首批渲染尖峰 |

运行独立的帧时间采集器
以下示例适用于使用原生 JavaScript 的 Vite + Three.js 项目。先执行命令创建实验环境,再用下面的代码完整替换 src/main.js。
npm create vite@latest perf-frame-lab -- --template vanilla
cd perf-frame-lab
npm install
npm install three
npm run dev预期结果:终端显示 Vite 开发服务器已启动,并给出实际访问地址;端口由运行环境决定。打开该页面与浏览器开发者工具的 Console 面板。
import * as THREE from 'three';
const startedAt = performance.now();
const renderer = new THREE.WebGLRenderer({ antialias: true });
renderer.setSize(innerWidth, innerHeight);
document.body.style.margin = '0';
document.body.appendChild(renderer.domElement);
const camera = new THREE.PerspectiveCamera(60, innerWidth / innerHeight, 0.1, 100);
camera.position.z = 18;
function makeScene(count) {
const result = new THREE.Scene();
result.background = new THREE.Color(0x0c1626);
// 同一场景内共享资源,避免把重复资源创建当成稳态压力。
const geometry = new THREE.BoxGeometry(0.35, 0.35, 0.35);
const material = new THREE.MeshNormalMaterial();
for (let i = 0; i < count; i++) {
const mesh = new THREE.Mesh(geometry, material);
mesh.position.set((i % 25 - 12) * 0.5, (Math.floor(i / 25) - 10) * 0.5, 0);
result.add(mesh);
}
result.userData.resources = [geometry, material];
return result;
}
let scene = makeScene(300);
let capture = { name: '启动期', frames: 120, samples: [] };
let lastTimestamp = null;
let firstRendered = false;
let firstInteracted = false;
let roaming = false;
function startCapture(name, frames) {
// 禁止采样重叠,否则一次尖峰会落入两个阶段。
if (capture) {
console.warn('上一组采样尚未结束');
return false;
}
capture = { name, frames, samples: [] };
return true;
}
function report(task) {
const sorted = [...task.samples].sort((a, b) => a - b);
const percentile = p => sorted[Math.ceil(sorted.length * p) - 1].toFixed(1);
const slowRate = (100 * sorted.filter(ms => ms > 33.3).length / sorted.length).toFixed(1);
console.log(`${task.name} n=${sorted.length} p50=${percentile(0.5)}ms p95=${percentile(0.95)}ms p99=${percentile(0.99)}ms max=${sorted[sorted.length - 1].toFixed(1)}ms >33.3ms=${slowRate}%`);
}
function animate(timestamp) {
if (lastTimestamp !== null && capture) {
const delta = timestamp - lastTimestamp;
// 标签页后台恢复后的长间隔不是正常游戏帧。
if (delta > 0 && delta < 250) {
capture.samples.push(delta);
if (capture.samples.length === capture.frames) {
report(capture);
if (capture.name === '连续漫游') roaming = false;
capture = null;
}
}
}
lastTimestamp = timestamp;
if (roaming) {
camera.position.x = Math.sin(timestamp * 0.0005) * 2;
camera.lookAt(0, 0, 0);
}
renderer.render(scene, camera);
if (!firstRendered) {
// render() 返回表示 CPU 提交完成,不保证像素已呈现。
console.log(`首次 render 返回: ${(performance.now() - startedAt).toFixed(1)} ms`);
firstRendered = true;
}
requestAnimationFrame(animate);
}
renderer.domElement.addEventListener('pointerdown', () => {
if (firstInteracted || !startCapture('首次交互', 120)) return;
firstInteracted = true;
scene.rotation.y += 0.2;
});
const panel = document.createElement('div');
panel.style.cssText = 'position:fixed;top:12px;left:12px;z-index:1';
function addButton(label, onClick) {
const button = document.createElement('button');
button.textContent = label;
button.addEventListener('click', onClick);
panel.appendChild(button);
}
addButton('漫游 300 帧', () => {
if (startCapture('连续漫游', 300)) roaming = true;
});
addButton('切换场景', () => {
if (!startCapture('场景切换', 120)) return;
const start = performance.now();
const oldScene = scene;
scene = makeScene(oldScene.children.length === 300 ? 500 : 300);
for (const resource of oldScene.userData.resources) resource.dispose();
console.log(`切换同步操作: ${(performance.now() - start).toFixed(1)} ms`);
});
document.body.appendChild(panel);
requestAnimationFrame(animate);预期输出(按启动完成、首次点击画布、漫游按钮、场景切换按钮的顺序操作;<TIME> 和 <RATE> 为设备相关的实际数值):
首次 render 返回: <TIME> ms
启动期 n=120 p50=<TIME>ms p95=<TIME>ms p99=<TIME>ms max=<TIME>ms >33.3ms=<RATE>%
首次交互 n=120 p50=<TIME>ms p95=<TIME>ms p99=<TIME>ms max=<TIME>ms >33.3ms=<RATE>%
连续漫游 n=300 p50=<TIME>ms p95=<TIME>ms p99=<TIME>ms max=<TIME>ms >33.3ms=<RATE>%
切换同步操作: <TIME> ms
场景切换 n=120 p50=<TIME>ms p95=<TIME>ms p99=<TIME>ms max=<TIME>ms >33.3ms=<RATE>%示例中的交互只是旋转场景;接入实际项目时,应把首次点击替换为真实的拾取、面板打开或角色控制动作,把场景切换替换为真实的加载与卸载逻辑。每组结束后再触发下一组,切换前不要重复点击。
从分布识别尖峰和持续掉帧
每个阶段至少看 p50、p95、p99、最大帧间隔和超 33.3 ms 比例。p50 接近日常体验,p95 显示较差的 5% 帧,最大值 暴露偶发长停顿。不要只比较平均 FPS:120 帧中即使有 1 帧耗时 120 ms,平均值也可能显得正常。
| 观察结果(示例数据) | p95 | 最大值 | 超 33.3 ms 比例 | 初步判断 |
|---|---|---|---|---|
| 首次交互 120 帧 | 17.4 ms | 96 ms | 0.8% | 单次尖峰 |
| 连续漫游 300 帧 | 41 ms | 78 ms | 24% | 持续掉帧 |
| 场景切换 120 帧 | 17.8 ms | 132 ms | 1.7% | 切换期尖峰 |
这些数字只演示判读方法,不是运行代码必然得到的结果。帧间隔来自相邻 requestAnimationFrame 回调的时间差,混合了刷新节奏、主线程阻塞等影响,不能直接当作 GPU 渲染耗时,也不是精确的输入到呈现延迟。120 Hz 设备约有 8.3 ms 的单帧预算,应按实际刷新率另设目标。
对照工具定位并复测
- 排查启动尖峰:开启 Chrome DevTools 的 Network 面板并勾选 Disable cache,重新加载至少 5 次;分别记录脚本执行到首次
render()返回的耗时,以及启动期分位数。前者不包含模块下载,也不能等同于真正的首屏呈现时间。真实 glTF 项目还要单独记录网络下载、解析解码与首批纹理上传时间。 - 排查首次交互与切换:在 Performance 面板录制相同操作;如果尖峰对应长脚本任务,优先检查同步对象创建、事件处理和垃圾回收;如果发生在首次绘制附近,再检查着色器编译、纹理上传与渲染相关工作。场景切换同步耗时只计 JavaScript 逻辑,不代表显存已经释放完成。
- 排查稳态问题:保持相同相机轨迹和场景对象数量,各录 3 轮连续漫游。若每轮 p95 都明显超出目标帧预算,才针对 draw call、像素填充、阴影或动画更新逐项做 A/B 对比。
- 复测与登记:记录设备、浏览器、分辨率、像素比、刷新率、是否冷缓存、阶段、样本量、p50/p95/p99、最大值与慢帧比例;改变一个因素后重复同样窗口,比较差值。
验收时,若场景切换仍有一次高峰但漫游 p95 回到目标内,说明稳态渲染已改善,启动与切换的尖峰应继续单独跟踪;不要把两种问题合并成一个“平均 FPS 已提高”的结论。