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。

bash
npm create vite@latest perf-frame-lab -- --template vanilla
cd perf-frame-lab
npm install
npm install three
npm run dev

预期结果:终端显示 Vite 开发服务器已启动,并给出实际访问地址;端口由运行环境决定。打开该页面与浏览器开发者工具的 Console 面板。

js
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> 为设备相关的实际数值):

text
首次 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 的单帧预算,应按实际刷新率另设目标。

对照工具定位并复测

  1. 排查启动尖峰:开启 Chrome DevTools 的 Network 面板并勾选 Disable cache,重新加载至少 5 次;分别记录脚本执行到首次 render() 返回的耗时,以及启动期分位数。前者不包含模块下载,也不能等同于真正的首屏呈现时间。真实 glTF 项目还要单独记录网络下载、解析解码与首批纹理上传时间。
  2. 排查首次交互与切换:在 Performance 面板录制相同操作;如果尖峰对应长脚本任务,优先检查同步对象创建、事件处理和垃圾回收;如果发生在首次绘制附近,再检查着色器编译、纹理上传与渲染相关工作。场景切换同步耗时只计 JavaScript 逻辑,不代表显存已经释放完成。
  3. 排查稳态问题:保持相同相机轨迹和场景对象数量,各录 3 轮连续漫游。若每轮 p95 都明显超出目标帧预算,才针对 draw call、像素填充、阴影或动画更新逐项做 A/B 对比。
  4. 复测与登记:记录设备、浏览器、分辨率、像素比、刷新率、是否冷缓存、阶段、样本量、p50/p95/p99、最大值与慢帧比例;改变一个因素后重复同样窗口,比较差值。

验收时,若场景切换仍有一次高峰但漫游 p95 回到目标内,说明稳态渲染已改善,启动与切换的尖峰应继续单独跟踪;不要把两种问题合并成一个“平均 FPS 已提高”的结论。

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

目录与阅读设置

阅读设置

17

记录一个想法

分开记录加载尖峰和稳态耗时

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

登录哪都通