Three.js + Ammo.js碰撞检测失效排查及物理引擎替代咨询

一、替代Ammo.js的物理引擎推荐 #

• Cannon.js：轻量级Web物理引擎，API设计友好，文档完善，社区活跃度高，适合大多数Web 3D场景的碰撞检测与物理模拟需求，学习成本低。
• Oimo.js：体积小巧，性能优异，支持常见碰撞形状，适合对包体积有严格要求的项目，能满足基础到中等复杂度的物理需求。
• Rapier.js：基于Rust编译的WebAssembly引擎，性能强劲，功能丰富，支持2D/3D物理模拟，类型安全，适合需要复杂物理交互的大型项目。

二、代码问题排查 #

以下是导致dispatcher.getNumManifolds()返回0的可能原因及修复方案：

1. 碰撞标志与静态物体质量不匹配 #

• 问题：静态物体（墙体、地面等）的btRigidBodyConstructionInfo传入质量为10（动态物体质量），却设置静态碰撞标志，物理引擎无法正确识别为静态物体，会导致物体受重力掉落，无法与角色产生碰撞；同时角色的碰撞标志flags.CF_CHARACTER_OBJECT可能未正确引用Ammo.btCollisionObject枚举。
• 修复：

  // createGltfRigidBodyAsBox函数中
  // 静态物体质量设为0
  let info = new Ammo.btRigidBodyConstructionInfo(0, motionState, shape, inertia);
  // 使用枚举常量设置静态碰撞标志，替代硬编码的2
  rigidBody.setCollisionFlags(Ammo.btCollisionObject.CF_STATIC_OBJECT);
  
  // initAmmoJsKinematicCharacterController函数中，确保碰撞标志引用正确
  bodyCapsuleShape.setCollisionFlags(Ammo.btCollisionObject.CF_CHARACTER_OBJECT);
  

2. 幽灵对象PairCallback设置时机错误 #

• 问题：btGhostPairCallback在添加角色后才设置，导致幽灵对象的碰撞对无法被正确初始化。
• 修复：在创建Broadphase后立即设置，移到initPhysicsUniverse函数中：

  function initPhysicsUniverse() {
      var collisionConfiguration = new Ammo.btDefaultCollisionConfiguration();
      var dispatcher = new Ammo.btCollisionDispatcher(collisionConfiguration);
      var broadphase = new Ammo.btDbvtBroadphase();
      // 提前设置GhostPairCallback
      broadphase.getOverlappingPairCache().setInternalGhostPairCallback(new Ammo.btGhostPairCallback());
      var solver = new Ammo.btSequentialImpulseConstraintSolver();
  
      physicsWorld = new Ammo.btDiscreteDynamicsWorld(dispatcher, broadphase, solver, collisionConfiguration);
      physicsWorld.setGravity(new Ammo.btVector3(0, -10, 0));
      // 将dispatcher设为全局变量，确保后续能正确访问
      window.dispatcher = dispatcher;
  }
  

3. 碰撞形状尺寸错误 #

• 问题：btBoxShape的参数是半尺寸（half-extents），但代码中直接传入模型的完整scale值，导致碰撞体尺寸与模型不匹配，无法触发碰撞。
• 修复：将模型尺寸除以2后传入：

  // createGltfRigidBodyAsBox函数中
  let btSize = new Ammo.btVector3(size.x/2, size.y/2, size.z/2);
  

4. 角色初始旋转未归一化 #

• 问题：new Ammo.btQuaternion(1, 1, 1, 1)未归一化，导致角色碰撞体朝向异常，无法正确与场景物体碰撞。
• 修复：使用无旋转的归一化四元数：

  // initAmmoJsKinematicCharacterController函数中
  transform.setRotation(new Ammo.btQuaternion(0, 0, 0, 1));
  

5. Dispatcher未全局引用 #

• 问题：initPhysicsUniverse中创建的dispatcher是局部变量，后续调用dispatcher.getNumManifolds()时可能访问无效对象，导致返回0。
• 修复：将dispatcher设为全局变量（如上述initPhysicsUniverse中的window.dispatcher = dispatcher），确保后续能访问到正确实例。

内容的提问来源于stack exchange，提问作者Ali