配置 Matter.js 睡眠机制以优化静止物体性能

在基于 2D 物理引擎构建沙盒游戏、积木堆叠或大规模粒子掉落场景时，场景中往往会堆积成百上千个物体。当大量物体掉落地面并逐渐停滞时，物理引擎若仍在对每个静止物体持续执行宽相包围盒比对、精细窄相碰撞检测以及接触约束迭代求解，帧率便会迅速跌落。Matter.js 内置了睡眠机制（Sleeping 模块），通过监测刚体的运动动能并冻结静止物体的物理计算，能使大量物体场景下的 CPU 开销降低 60% 以上。本文将详细讲解 Matter.js 睡眠机制的底层工作机制、标准启用步骤、关键参数调优方法以及实际开发中常见的抖动排查手段。

一、Matter.js 睡眠机制的底层运作原理

Matter.js 的主模拟循环通常由四个阶段组成：碰撞粗筛（Broadphase）、精确碰撞狭相检测（Narrowphase）、接触与外力求解（Constraint/Velocity Solver），以及位置积分更新（Position Integration）。在未启用睡眠机制时，即便一个刚体肉眼看起来完全静止，引擎每个物理周期（Tick）依然会对其计算重力加速度、求解与周围物体的微小碰撞接触并更新坐标。

当开启睡眠机制后，Matter.js 会在内部为每个非静态刚体维护一个运动能量计数器 body.motion。该值的更新公式依赖刚体的平移速率与角速度平方：

// Matter.js 内部对刚体运动动能的平滑滤波计算公式示意
body.motion = 0.99 * body.motion + 0.01 * (body.speed * body.speed + body.angularSpeed * body.angularSpeed);

当该刚体的 body.motion 连续低于休眠判定阈值达到指定帧数（默认为 60 帧）时，引擎会将该刚体的 body.isSleeping 标记置为 true。一旦进入休眠状态：

• 跳过重力与速度积分：引擎不会再为该刚体累加速度与位置变化，速度与角速度直接保持为 0。
• 跳过休眠物体对之间的狭相检测：当两个互相接触或相邻的物体均处于 isSleeping: true 状态时，窄相碰撞检测和约束迭代直接跳过。
• 被动碰撞唤醒：只要有任意处于活跃状态的活动物体（或外部代码施加的力）与该休眠刚体发生触碰，休眠刚体会被瞬时唤醒，重新加入物理求解管线。

二、启用与配置睡眠机制的操作步骤

在 Matter.js 中启用睡眠机制并不复杂，但需要分别在引擎级（全局）与刚体级（个体）进行协同配置，以保证物理效果与性能收益兼顾。标准落地步骤包括以下四个环节：

步骤 1：在创建 Engine 时开启全局选项

Matter.js 默认将 enableSleeping 设为 false。必须在初始化引擎或创建后显式开启：

import Matter from 'matter-js';

const { Engine, Render, Runner, Bodies, Composite, Events, Sleeping } = Matter;

// 创建物理引擎，开启睡眠支持
const engine = Engine.create({
  enableSleeping: true // 核心配置：开启休眠逻辑调度
});

// 若引擎已创建，也可直接属性赋值：
// engine.enableSleeping = true;

步骤 2：针对刚体调整休眠判定阈值与物理材质

在 Matter.js 中，刚体具备两个决定休眠触发的关键属性：

• sleepThreshold（默认值：60）：连续检测到 body.motion 低于休眠判定水平所需的更新周期数。在标准 60 FPS 刷新率下，60 对应约 1 秒的相对静止时间。
• frictionAir（空气阻尼）与 friction（摩擦系数）：阻尼直接影响刚体动能耗散速率。如果一个物体在光滑斜面上因重力持续产生微量滑移，动能将无法跌落至阈值以下，从而永远无法入睡。

// 创建支持休眠的方块刚体
const box = Bodies.rectangle(400, 200, 60, 60, {
  restitution: 0.2,       // 弹性：较低弹性利于快速减速
  friction: 0.8,          // 地面接触摩擦
  frictionAir: 0.02,      // 适度增加空气阻力，消除高频微震
  sleepThreshold: 45      // 约 0.75 秒静止后即可进入睡眠
});

Composite.add(engine.world, box);

步骤 3：监听刚体休眠与唤醒事件

当刚体进入或退出休眠状态时，Matter.js 会在刚体自身以及 Events 模块上派发 sleepStart 与 sleepEnd 事件。这常用于调试、控制自定义渲染管道（如降低静止物体的绘制刷新频率）或显示视觉反馈：

// 监听指定刚体的休眠触发
Events.on(box, 'sleepStart', (event) => {
  console.log(`刚体 [ID: ${box.id}] 进入休眠状态`);
  // 调试反馈：休眠时修改渲染填充色以可视化验证
  box.render.fillStyle = '#94A3B8';
});

// 监听指定刚体的唤醒触发
Events.on(box, 'sleepEnd', (event) => {
  console.log(`刚体 [ID: ${box.id}] 被唤醒`);
  box.render.fillStyle = '#345E82';
});

// 也可在全局监听所有刚体的休眠变化
Events.on(engine, 'afterUpdate', () => {
  // 检查特定逻辑
});

步骤 4：通过代码显式控制休眠与唤醒

当通过 JavaScript 逻辑直接改变刚体的坐标（Body.setPosition）或直接赋予初速度（Body.setVelocity）时，如果刚体处于 isSleeping === true 状态，由于跳过了常规更新，可能出现物理响应延迟或运动判定不同步。此时应使用 Sleeping.set 显式唤醒：

// 手动唤醒刚体
Sleeping.set(box, false);

// 施加冲量或瞬间位移
Matter.Body.applyForce(box, box.position, { x: 0.05, y: -0.08 });

// 若需要强制让某些刚体立即静止休眠（例如开局摆放静态积木）：
// Sleeping.set(box, true);

三、刚体状态流转机理与触发条件

理解刚体在活动、沉降（Settling）与休眠之间的状态机转换，有助于在调试物理场景时准确判断物体为何“不睡觉”或“被意外唤醒”。

四、实际应用中的常见问题与排查指南

1. 物体在地表或堆叠时持续微颤，无法进入休眠

现象描述：多个盒子堆叠成金字塔或方塔时，由于重力约束与法向穿透修正反冲，盒子之间不断产生微小位移，body.motion 始终徘徊在 0.1~0.3 之间，无法触发 sleepStart。

解决手段：

• 调高空气阻尼：适度提高 frictionAir（例如从默认的 0.01 调整到 0.02 ~ 0.04），吸收高频微小晃动的动能。
• 合理配置摩擦与弹性：堆叠物体的 restitution（弹性系数）应尽量设为 0 或不超过 0.2；同时保证 friction 维持在 0.5 以上。
• 提高物理引擎迭代求解次数：在 Engine 配置中微调 positionIterations: 8 和 velocityIterations: 8。迭代精度更高能够减少穿透抖动，从而加速系统收敛静止。

2. 滚动物体或低速滑行刚体过早休眠并“悬停”

现象描述：一个平滑下落的球体或沿缓坡滚动的圆盘，在尚未触底时突然悬停在半空。

解决手段：这是由于 sleepThreshold 设置过小（例如设置为了 10 或 15）。当物体在某一瞬间速度极低时，引擎误判其已静止。通常应保持 sleepThreshold >= 45（建议 60~90 之间），并避免对需要长时间连续低速匀速滑行的特定物体开启休眠（可通过将该刚体的 sleepThreshold: Infinity 专门禁用单个物体的自动休眠）。

3. 通过代码操作 Transform 后物理失效

现象描述：开发者使用鼠标拖拽刚体，或直接通过 Body.setPosition(body, newPos) 修改位置后，刚体悬在空中不动，不响应后续重力。

解决手段：如果该刚体先前已经处于 isSleeping === true 状态，单纯更改其 position 不会自动改变其内部休眠标记。必须在修改属性的同时调用 Sleeping.set(body, false) 强制将其激活。

五、性能调优总结与配置选型参考

在包含大量静态场景组件（如地形、障碍物、堆叠箱子、战利品掉落物）的游戏与仿真项目中，合理利用静态刚体（isStatic: true）与休眠机制（enableSleeping: true）是维持 60 FPS 稳定运行的核心原则。

综上所述，配置 Matter.js 的睡眠机制是优化多物体物理场景最直接且低侵入性的手段。在初始化阶段将 enableSleeping 设为 true，再结合实际物体的阻尼、弹性与 sleepThreshold 参数进行细调，就能使大量堆叠或静止物体在无需物理计算时平稳“入眠”，保障前端渲染与交互的流畅性。