Web 图形与 3D / 系统课时
用渲染循环更新场景状态
用渲染循环更新场景状态
本课把静止的 Three.js 立方体变成持续旋转、横向往返的动画,同时避免高刷新率设备上的运动速度翻倍。你会用 requestAnimationFrame 获取帧时间,换算时间增量,先更新对象状态再渲染,并处理切回标签页与窗口缩放。
学习目标
- 计算相邻帧的秒级时间增量,并正确处理首次回调。
- 用时间增量驱动旋转与位移,而不是每帧累加固定步长。
- 运行完整示例,检查不同帧率、后台恢复及画布缩放下的表现。
帧回调与时间差
requestAnimationFrame(callback) 请求浏览器在下一次适合绘制的时机调用回调;它不会以固定 60 FPS 运行。回调收到的 timeMs 是毫秒时间戳,上一帧时间戳记为 lastTimeMs,两者之差除以 1000 才是用于运动计算的秒数。
例如,相邻时间戳是 1000 ms 和 1016.7 ms,则 秒;旋转角速度为 0.8 弧度/秒时,本帧角度增加约 0.0134 弧度。首次回调没有上一帧,时间增量应取 0,不能直接拿时间戳当作帧耗时。

完整运行示例
在空目录创建 index.html,写入以下页面。示例使用 Three.js r180 的 ES Module CDN,需联网并通过本地 HTTP 服务打开。场景、相机和 WebGLRenderer 只创建一次,每帧只更新物体属性并调用 renderer.render。
<!doctype html>
<html lang="zh-CN">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>Three.js 时间驱动动画</title>
<style>
html, body { margin: 0; width: 100%; height: 100%; overflow: hidden; }
</style>
<script type="importmap">
{
"imports": {
"three": "https://cdn.jsdelivr.net/npm/three@0.180.0/build/three.module.js"
}
}
</script>
</head>
<body>
<script type="module">
import * as THREE from 'three';
const scene = new THREE.Scene();
scene.background = new THREE.Color(0xf3f7fa);
const camera = new THREE.PerspectiveCamera(
60, window.innerWidth / window.innerHeight, 0.1, 100
);
camera.position.set(0, 1.5, 5);
camera.lookAt(0, 0, 0);
const renderer = new THREE.WebGLRenderer({ antialias: true });
renderer.setPixelRatio(Math.min(window.devicePixelRatio, 2));
renderer.setSize(window.innerWidth, window.innerHeight);
document.body.appendChild(renderer.domElement);
const geometry = new THREE.BoxGeometry(1, 1, 1);
const material = new THREE.MeshNormalMaterial();
const cube = new THREE.Mesh(geometry, material);
scene.add(cube);
let lastTimeMs = null;
let elapsedSeconds = 0;
let rafId = 0;
function animate(timeMs) {
// 首帧取 0;后台恢复时将单帧增量限制在 50 毫秒以内
const dt = lastTimeMs === null
? 0
: Math.min((timeMs - lastTimeMs) / 1000, 0.05);
lastTimeMs = timeMs;
elapsedSeconds += dt;
// 自转速度 0.8 弧度/秒;沿 X 轴往返,振幅 1 个世界单位
cube.rotation.y += 0.8 * dt;
cube.position.x = Math.sin(elapsedSeconds * 1.2);
renderer.render(scene, camera);
rafId = requestAnimationFrame(animate);
}
rafId = requestAnimationFrame(animate);
window.addEventListener('resize', () => {
camera.aspect = window.innerWidth / window.innerHeight;
camera.updateProjectionMatrix();
renderer.setSize(window.innerWidth, window.innerHeight);
});
</script>
</body>
</html>预期结果:浏览器显示一个多色立方体,一边绕 Y 轴自转,一边在 X 轴的 -1 到 +1 世界单位之间平滑往返;缩放窗口后,立方体不会被拉伸。
在该目录启动本地服务器(已安装 Python 3):
python3 -m http.server 8000预期结果:终端显示正在监听 8000 端口;访问 http://localhost:8000/ 可看到上述动画。这里的 8000 是示例指定端口,若被占用可换一个可用端口并同步修改浏览器地址。
按数值检查运动速度
示例中 cube.rotation.y += 0.8 * dt 表示每秒旋转 0.8 弧度,而不是每帧旋转 0.8 弧度。理想情况下,不同帧率经过同样的真实时间,累计角度应近似一致:
| 刷新频率 | 典型单帧 dt |
单帧旋转增量 | 约 1 秒累计 |
|---|---|---|---|
| 30 FPS | 0.0333 s | 0.0267 rad | 0.8 rad |
| 60 FPS | 0.0167 s | 0.0133 rad | 0.8 rad |
| 120 FPS | 0.0083 s | 0.0067 rad | 0.8 rad |
横向移动由 sin(elapsedSeconds * 1.2) 给出:振幅为 1 个世界单位,周期约为 5.24 秒,不会因帧率升高而加快。把角速度系数 0.8 改为 1.6,观察自转速度是否约翻倍;如果将代码误写成每帧固定加 0.8,高帧率设备就会转得更快。
处理长帧与停止渲染
浏览器切换到后台时,动画回调通常暂停或降频;返回页面后,原始时间差可能远大于一帧。示例使用 Math.min(实际秒数, 0.05) 将单次增量上限设为 50 ms,避免立方体突然大幅跳动。代价是长时间暂停不会被一次性补算,因此这里的 elapsedSeconds 表示参与动画计算的累计时间,而非严格墙上时钟时间。
对于刚体物理或碰撞检测,不能只依靠限幅后的可变步长;应采用固定模拟步长(例如 1/60 秒)与累积器。单纯展示模型时,也不必为静止场景永久运行循环:可以在交互改变场景后按需渲染。
如果在单页应用里卸载这一页面,先通过 cancelAnimationFrame(rafId) 停止后续回调,再调用 geometry.dispose()、material.dispose()、renderer.dispose() 并移除画布;否则重复进入页面可能积累多个动画循环和 GPU 资源。WebXR 场景则应优先使用 Three.js 的 renderer.setAnimationLoop() 接管循环。