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 设置为所需的速度。

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

另请参阅 Qt Quick 3D 中的“物理形状、物体和关节”。

属性文档

collisions : Collisions [read-only]

该属性保存角色的当前碰撞状态。其取值为None （表示无碰撞），或是Side 、Up 和Down 的按“或”运算组合：

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 ，无需检查碰撞。调用方有责任避免与静态对象发生重叠。