Web 图形与 3D / 系统课时

页面隐藏时暂停无效渲染

页面隐藏时暂停无效渲染

切到后台后,浏览器可能限制动画帧,但业务更新和额外定时任务仍可能消耗资源。本课把页面可见性与组件挂载状态合成一个运行条件,使 Three.js 在隐藏时暂停、恢复时只重启一次,并在卸载后彻底停止。

学习目标

  • 使用 document.hidden 与 visibilitychange 判断页面是否可见。
  • 用组件挂载状态控制 WebGLRenderer.setAnimationLoop 的启停与清理。
  • 验证切换标签页、恢复显示和组件卸载时不会重复渲染或跳帧。

运行条件与状态切换

只有同时满足“组件已挂载”和“页面可见”才允许更新场景与调用 renderer.render()。浏览器可能自动限速后台的 requestAnimationFrame,但不能依赖这种限速代替业务暂停;setInterval、Worker 或网络消息处理也不会因为渲染循环停止而自动终止。

页面可见性、组件挂载与渲染循环的状态转换

暂停只停止动画循环并保留场景,以便回来后继续;卸载则移除事件监听、释放几何体、材质和渲染器。仅用页面可见性判断会漏掉路由切换或组件卸载,因此必须同时管理这两个条件。

编写可反复挂载的示例

下面是完整的 HTML 示例,使用 Three.js 0.180.0。保存为 index.html,通过本地静态服务器预览;浏览器需要联网加载模块。按钮模拟组件挂载与卸载,切换浏览器标签页模拟页面隐藏和恢复。

html
<!doctype html>
<html lang="zh-CN">
<head>
  <meta charset="utf-8">
  <meta name="viewport" content="width=device-width,initial-scale=1">
  <title>页面隐藏时暂停渲染</title>
  <style>
    #stage { width: min(100%, 640px); height: 320px; }
    #stage canvas { display: block; }
  </style>
</head>
<body>
  <button id="toggle">卸载场景</button>
  <span id="status"></span>
  <div id="stage"></div>
  <script type="module">
    import * as THREE from 'https://cdn.jsdelivr.net/npm/three@0.180.0/build/three.module.js';

    const stage = document.querySelector('#stage');
    const status = document.querySelector('#status');
    const button = document.querySelector('#toggle');

    function mountScene() {
      const scene = new THREE.Scene();
      scene.background = new THREE.Color(0xf2f6fa);
      const camera = new THREE.PerspectiveCamera(55, 1, 0.1, 100);
      camera.position.z = 4;
      const geometry = new THREE.BoxGeometry(1.5, 1.5, 1.5);
      const material = new THREE.MeshNormalMaterial();
      const cube = new THREE.Mesh(geometry, material);
      scene.add(cube);

      const renderer = new THREE.WebGLRenderer({ antialias: true });
      renderer.setPixelRatio(Math.min(window.devicePixelRatio, 2));
      stage.appendChild(renderer.domElement);

      function resize() {
        const width = stage.clientWidth;
        const height = stage.clientHeight;
        camera.aspect = width / height;
        camera.updateProjectionMatrix();
        renderer.setSize(width, height);
      }

      let mounted = true;
      let running = false;
      let lastTime = null;

      function frame(time) {
        // 恢复后的第一帧使用零增量,避免把后台时间补算进去。
        const dt = lastTime === null ? 0
          : Math.min((time - lastTime) / 1000, 0.05);
        lastTime = time;
        cube.rotation.y += dt * 1.5;
        renderer.render(scene, camera);
      }

      function syncLoop() {
        const shouldRun = mounted && !document.hidden;
        if (shouldRun === running) return; // 防止重复启动或重复停止
        running = shouldRun;
        lastTime = null;
        renderer.setAnimationLoop(running ? frame : null);
        status.textContent = running ? '运行中' : '页面隐藏,已暂停';
      }

      function unmount() {
        mounted = false;
        syncLoop();
        document.removeEventListener('visibilitychange', syncLoop);
        window.removeEventListener('resize', resize);
        // 只有卸载才释放资源;单纯隐藏页面不要 dispose。
        geometry.dispose();
        material.dispose();
        renderer.dispose();
        renderer.domElement.remove();
        status.textContent = '已卸载';
      }

      window.addEventListener('resize', resize);
      document.addEventListener('visibilitychange', syncLoop);
      resize();
      status.textContent = '页面隐藏,已暂停';
      syncLoop();
      return unmount;
    }

    let unmount = mountScene();
    button.addEventListener('click', () => {
      if (unmount) {
        unmount();
        unmount = null;
        button.textContent = '挂载场景';
      } else {
        unmount = mountScene();
        button.textContent = '卸载场景';
      }
    });
  </script>
</body>
</html>

预期结果:页面可见时立方体持续旋转,状态显示“运行中”;切到其他标签页后动画循环暂停,回来后从原来的角度继续旋转;点击“卸载场景”后画布消失,返回该标签页也不会自行重建;再次点击“挂载场景”才创建新场景。

验证暂停与恢复

  1. 在前台观察立方体连续旋转,状态为“运行中”。
  2. 切换到其他标签页约 10 秒,再切回来;状态恢复为“运行中”,立方体没有突然旋转多个整圈。
  3. 点击“卸载场景”,确认画布被移除;再次切走、切回,画布仍不存在。
  4. 重复挂载、卸载 3 次,检查每次只出现一个画布、一个旋转立方体。

隐藏期间的 10 秒不应累计到旋转增量中。代码在启停时把 lastTime 重置为 null,并把单帧 dt 限制为最多 0.05 秒:角速度为每秒 1.5 弧度时,单帧最多增加 0.075 弧度,避免恢复瞬间大幅跳动。

处理独立于渲染的业务任务

如果业务还有 setInterval、物理模拟定时器、粒子 Worker 或连续轮询,需要在同一个可见性策略中分别暂停或降频,并在恢复时重新同步。renderer.setAnimationLoop(null) 仅停止该渲染器的动画回调,不会自动取消这些任务,也不会终止已有网络连接。

在 React 的 useEffect 清理函数、Vue 的 onUnmounted 或路由组件销毁回调中执行与示例 unmount() 等价的清理;不要在每次恢复可见时重新 new WebGLRenderer()。对页面隐藏只做暂停,对组件真正卸载才释放独占资源,才能避免重复监听、重复循环和资源残留。

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

目录与阅读设置

阅读设置

17

记录一个想法

页面隐藏时暂停无效渲染

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

登录哪都通