用途:在 React Three Fiber 项目中接入 Rapier 物理引擎,实现刚体、碰撞体、力、传感器和关节,适合碰撞驱动的运动与模拟。
主要能力:支持动态、固定、位置运动学和速度运动学刚体;提供 cuboid 等碰撞体与复合凸形;支持冲量、持续力、传感器进出事件、碰撞分组、关节(固定、旋转、球、弹簧、绳索)以及角色控制器。
使用方式:先确认已安装的 Fiber、React 与 Rapier 版本,Rapier 2 对应 Fiber 9 / React 19,旧项目需使用兼容版本。在 Canvas 下挂载 Physics,物理以 WASM 异步加载,需配合 Suspense。RigidBody 上设置初始变换,碰撞体尺寸为半长(与 BoxGeometry 全尺寸不同)。手动提供完整碰撞体时设 colliders={false}。需要与模拟步对齐的输入或力用 useBeforePhysicsStep;固定时间步更稳定,timeStep="vary" 会牺牲可预测性。按需渲染时用 Physics updateLoop="independent"。
限制与注意:不要在 useFrame 中动画化受模拟网格的位置,物理世界才是权威;冲量是一次性动量变化,力会持续累积,避免每帧重复添加同一持续力;传感器用相交事件而非普通碰撞事件;碰撞分组需两侧掩码兼容;关节使用局部锚点与轴而非世界坐标;恢复世界快照需匹配刚体创建与句柄关系。验证时检查静止接触、碰撞体对齐、冲量、休眠/唤醒及不同渲染帧率,并测试传感器进出、快速物体穿透和 Strict Mode 重挂载。
资料未提供收费、价格与平台信息。