Qt Quick 3D 物理 API 相较于技术预览版的变更

从 Qt 6.5.0 版本开始，Qt Quick 3D 物理模块不再处于技术预览阶段。基于对 API 的反馈和审查流程，我们进行了一些源代码不兼容的更改。

大部分更改是重命名类型和属性，以与其他 API 保持一致，并使名称更具描述性。最显著的重命名是将DynamicsWorld 更改为PhysicsWorld ，这将影响所有应用程序。

最重要的行为变更在于对 `kinematic bodies` 的处理方式。调整运动学体的位置/方向不再通过 `Node ` 属性（如 `position`、`rotation` 等）实现，而是改用以下新属性：kinematicPosition 、kinematicEulerRotation 、kinematicRotation 以及kinematicPivot 。 进行此更改的目的是确保运动学体的视觉移动与模拟的其余部分保持同步，而不是提前一个模拟步发生。

DynamicRigidBody.density 属性不再将负值（和零）视为特例。取而代之的是，有两个新的massMode 枚举值取代了Density ：

enableTriggerReports 属性已重命名为sendTriggerReports 。此外，现在可以通过设置receiveTriggerReports 来通知物理对象其已进入触发体。

以下是所有 API 变更的完整列表：

• CollisionShape:
  • 将 `enableDebugView` 重命名为enableDebugDraw
• 将抽象基类CollisionNode 重命名为PhysicsNode
  • 将 `enableTriggerReports` 更改为 `sendTriggerReports `，并且receiveTriggerReports
• CharacterController
  • 将 `speed ` 重命名为movement
• ConvexMeshShape
  • 将meshSource 重命名为source
• HeightFieldShape
  • 将heightMap 重命名为source
• TriangleMeshShape
  • 将meshSource 重命名为source
• PhysicsWorld （从DynamicsWorld 重命名而来）
  • 将forceDebugView 重命名为forceDebugDraw
  • 将minTimestep/maxTimestep 重命名为minimumTimestep/maximumTimestep
  • 移除了 sceneNode
  • 已添加scene
  • 已添加viewport
• DynamicRigidBody
  • 将axisLockLinearX/Y/Z 的属性合并为单个属性linearAxisLock ，该属性采用位域形式
  • 将axisLockAngularX/Y/Z 属性合并为单一属性angularAxisLock ，该属性采用位域
  • 新增了以下属性：kinematicPosition 、kinematicEulerRotation 、kinematicRotation ，以及kinematicPivot
  • 将Density 枚举值改为DefaultDensity/CustomDensity ，并移除了对负值的特殊处理。
  • 将linearVelocity 属性替换为setLinearVelocity 方法。
  • 将angularVelocity 属性替换为setAngularVelocity 方法。