CharacterController QML Type

控制字符的运动。更多

• 所有成员（包括继承成员）的列表

属性

• collisions : Collisions
• enableShapeHitCallback : bool (since 6.6)
• gravity : vector3d
• midAirControl : bool
• movement : vector3d

信号

• shapeHit(PhysicsNode *body, vector3D position, vector3D impulse, vector3D normal) (since 6.6)

方法

• void teleport(vector3d position)

详细说明

CharacterController 类型控制角色的运动。

角色是在外部控制下移动的实体，但仍受物理障碍物的限制，并（可选择）受重力影响。这与dynamic rigid bodies 不同，后者要么完全由物理模拟控制（对于非运动体），要么不受障碍物影响（对于运动物体），完全按照放置的位置移动。

要控制角色控制器的运动，可将movement 设置为所需的速度。

对于第一人称视角，摄像机通常放置在角色控制器内。

另请参阅 形状和主体概述文档。

属性文档

collisions : Collisions [read-only]

该属性保存字符当前的碰撞状态。它要么是None 表示无碰撞，要么是Side 、Up 和Down 的 OR 组合：

enableShapeHitCallback : bool [since 6.6]

此属性可启用/禁用该字符控制器的CharacterController::shapeHit 回调。

默认值：false

此属性在 Qt 6.6 中引入。

gravity : vector3d

该属性定义了适用于角色的重力加速度。对于在地面上行走的角色，通常应将重力加速度设置为PhysicsWorld.gravity 。在三维空间中具有移动控制功能的浮动角色，其重力加速度通常为(0, 0, 0) 。

默认值：(0, 0, 0) 。

midAirControl : bool

该属性定义了当角色处于自由落体状态时，movement 属性是否有效。只有当gravity 不为空时，该属性才会生效。true 的值表示当movement 发生变化时，角色会在半空中改变方向。如果值为false ，则表示角色将继续保持当前轨迹，直到撞上其他物体。

默认值：true

movement : vector3d

该属性定义了角色的受控运动。这是角色在没有重力且不与其他物理对象交互的情况下的运动速度。

该属性并不反映角色的实际速度。如果角色被地形卡住，其移动速度会低于movement 所定义的速度。相反，如果角色处于自由落体状态，其移动速度可能会快很多。

默认值：(0, 0, 0)

信号 文档

[since 6.6] shapeHit(PhysicsNode *body, vector3D position, vector3D impulse, vector3D normal)

当调用movement 并导致与DynamicRigidBody 或StaticRigidBody 发生碰撞，且enableShapeHitCallback 设置为true 时，将发出该信号。参数body,position,impulse 和normal 包含接触点的主体、位置、冲力和法线。

该信号在 Qt 6.6 中引入。

方法文档

void teleport(vector3d position)

在不检查碰撞的情况下立即将字符移动到position 。调用者有责任避免与静态对象重叠。