SuperAPI AI 工具集

physics

编程与开发

查看项目

更新于 11-08 11:40

技能介绍

用途:为静态与运动学几何体提供基于 BVH(包围体层次结构)的物理支持,主要依赖 @pmndrs/viverse。资料明确指出,动态刚体之间目前尚不能相互交互。

主要能力:

  1. 物理世界:使用 BvhPhysicsWorld 创建物理世界。addBody(object, kinematic) 的第二个参数表示物体是否为运动学物体,即由脚本逐帧移动的物体(如平台、列车),并不表示物体是否为静态。静态世界几何(地面、墙壁)传 false,自己移动的物体传 true。需注意:addBody 的第二个标志含义是 kinematic,而 addSensor 的第二个标志含义是 isStatic,两者布尔含义相反。
  2. 角色控制器:BvhCharacterPhysics 是角色控制器,负责移动角色并处理碰撞,但不对角色做动画,也不是摄像机。若要实现完整可控的人形角色,需要与 CharacterCameraBehavior(摄像机)以及 Acta(动画及其产生的运动)组合使用;资料明确不建议使用 SimpleCharacter,因为它自带动画,会与 Acta 冲突。
  3. 驱动与更新:通过 inputVelocity.copy(velocity) 设置每帧连续速度(如行走),通过 applyVelocity(jumpImpulse) 施加一次性冲量(如跳跃)。设置速度后,每帧调用 characterPhysics.update(character, delta),可传入第三个参数 BvhCharacterPhysicsOptions 进行调参,包括 capsuleRadius、capsuleHeight、gravity、maxGroundSlope、updatesPerSecond、linearDamping。
  4. 地面检测:characterPhysics.isGrounded 在角色位于地面时为 true。
  5. 传感器:通过 world.addSensor(object, isStatic, callback) 检测角色进入或离开体积,回调参数 intersected 为 true 表示进入、false 表示离开;通过 world.removeSensor(object) 移除传感器。

使用方式要点:

  • 控制器假设角色对象的原点位于脚部(胶囊底部)。若模型原点在中心或头部,角色会悬浮或下沉,需要用原点位于脚部的 Group 包裹。
  • 对 Acta 角色,信息流为输入 → Acta → 物理:向 Acta 传入相机相对的 moveDirection(长度 0..1)作为移动意图,Acta 将当前动画转为期望速度并通过 motion 回调交回,再把该速度设为 inputVelocity 并在此步进控制器。资料明确不要用原始输入设置 inputVelocity,也不要在其他地方移动角色。

适用场景与限制: 适用于需要静态/运动学碰撞的游戏场景,如地面行走、跳跃冲量、进入/离开触发区域等。控制器刻意保持最小化,只提供 inputVelocity、applyVelocity 和 isGrounded 三类原语,以下游戏规则需自行编写:多段跳/二段跳、土狼时间、跳跃缓冲(无跳跃计数器,需自行统计空中跳跃次数并在落地时重置);蹬墙跳/贴墙滑行(isGrounded 只报告地面,需从胶囊做水平 world.raycast(ray, far) 检测墙体);随移动平台移动(站上运动学平台不会被带走,需自行叠加平台每帧位移);越界坠落(有限地面网格边缘之外无碰撞体,角色会一直下落并卡在滞空姿态,控制器不会阻止,需自行限制位置、增加越界地板或重生屏障)。这些属于游戏玩法规则,并非缺失功能。