isKinematic 为 false 时调用move() 后物理碰撞会失效

[zhuxudong]

Describe the bug
hit.entity.getComponent(DynamicCollider)?.move(hit.entity.transform.position.add(new Vector3(1)));

[luzhuang]

问题分析

move() 方法内部调用 PhysX 的 setKinematicTarget() API，这是专门为 kinematic 刚体设计的。

当在 isKinematic = false 的动态刚体上调用时，PhysX 会隐式将刚体转为 kinematic 模式，导致：

1. 引擎层 _isKinematic 仍然是 false
2. PhysX 底层已变成 kinematic
3. Kinematic 刚体不会与 static/kinematic 碰撞体产生碰撞响应 → "碰撞失效"

修复方案

在 move() 方法中添加 isKinematic 检查，非 kinematic 时打印警告并 return：

move(positionOrRotation: Vector3 | Quaternion, rotation?: Quaternion): void {
  if (\!this._isKinematic) {
    console.warn("DynamicCollider.move() should only be called when isKinematic is true.");
    return;
  }
  this._phasedActiveInScene && (<IDynamicCollider>this._nativeCollider).move(positionOrRotation, rotation);
}

API 注释已经说明 move() 是用于 "kinematically controlled dynamic actors"，这个修复符合设计意图。