SuperAPI AI 工具集

gaia-physics

编程与开发

查看项目

更新于 11-08 11:40

技能介绍

gaia-physics 是一个游戏开发方向的物理技能,使用 BVH(Bounding Volume Hierarchy,层次包围盒)为静态与运动学几何体提供物理计算,底层依赖 @pmndrs/viverse 库。资料明确指出,目前动态刚体之间尚不能相互交互。

用途方面,该技能主要服务于游戏中的角色移动与场景碰撞需求,包括搭建物理世界、构建角色控制器、进行地面检测,以及使用传感器体积判断角色进入或离开某个区域。

主要能力包括:

  1. 物理世界:通过 BvhPhysicsWorld 创建物理世界实例。
  2. 刚体添加:world.addBody(object, isKinematic) 可添加静态刚体(第二参数为 false)或运动学刚体(第二参数为 true)。
  3. 角色控制器:通过 BvhCharacterPhysics(world) 创建角色物理控制器;使用 applyVelocity 施加一次性速度(例如跳跃),使用 inputVelocity 设置持续速度(例如行走)。资料特别提示,对于带动画的人形角色不要直接设置 inputVelocity,而应使用 applyMove 回调模式,否则角色在待机或攻击动画期间会出现滑动。
  4. 逐帧更新:设置速度后需每帧调用 characterPhysics.update(character, delta, {} satisfies BvhCharacterPhysicsOptions)。
  5. 地面状态:通过 characterPhysics.isGrounded 判断角色是否位于地面。
  6. 传感器体积:world.addSensor(object, isStatic, callback) 添加传感器,回调参数 intersected 为真表示角色进入、为假表示离开;world.removeSensor(object) 移除传感器。若希望使用统一的进入回调,可为每个传感器包装回调,在 intersected 为真时调用 onEnter(object),并传入对应对象。

使用方式上,需先在项目中引入 @pmndrs/viverse,按上述 API 创建物理世界、添加场景几何体、创建角色控制器,并在每帧循环中设置速度后调用 update。传感器则按需添加并在回调中处理进入/离开逻辑。

适用场景包括:静态关卡地形与移动平台(运动学刚体)上的角色行走与跳跃、地面检测、以及触发区域(如进入某范围时触发事件)。限制在于动态刚体之间暂不支持相互交互,且人形动画角色需遵循 applyMove 回调模式而非直接设置 inputVelocity。关于安装命令、收费与授权方式等,资料暂未提供。