threejs-physics

物理集成

使用项目中已安装的版本和现有架构。这些说明用于补充用户的任务，不代表可以进行无关的更改或外部操作。

检查现有引擎及其版本；除非所需行为要求更改，否则应予以保留。创建物理世界前，先初始化其 WASM／运行时。明确单位、重力方向、碰撞体比例，以及各变换的控制权。

使用固定时间步长和有界累加器推进模拟。限制子步数，并明确选择在卡顿后是否丢弃超出的时间。必要时，在渲染时插值物理上一帧和当前帧的姿态。避免在多个循环中推进模拟。

如果基本形状或复合碰撞体足以还原交互效果，优先使用它们。检查引擎对动态三角网格、缩放和凸包的限制。可视网格并不一定能作为稳定的碰撞体。在测量成本后，再对高速物体选择性地使用连续碰撞检测。

通过引擎 API 移动运动学刚体；不要只写入渲染变换并期望物理跟随。按预期的频率施加力／冲量，并处理休眠和碰撞事件的生命周期。避免事件处理触发重复的 UI 操作。

拆卸时释放物理世界对象和监听器。测试最高预期速度下的碰撞、静止稳定性、低帧率、切回标签页后的恢复、比例变化以及重复重置。未经测试，不要承诺跨平台确定性回放。

API 参考

如需准确的签名和特定修订版本的行为，请查阅官方文档。如果无法访问文档，请检查已安装的类型定义／源码，并说明仍存在的任何不确定性。