CharacterController QML Type
Controla los movimientos de un personaje. Más...
| Import Statement: | import QtQuick3D.Physics |
| Since: | Qt 6.4 |
| Inherits: |
Propiedades
- collisions : Collisions
- enableShapeHitCallback : bool
(since 6.6) - gravity : vector3d
- midAirControl : bool
- movement : vector3d
Señales
- shapeHit(PhysicsNode *body, vector3D position, vector3D impulse, vector3D normal)
(since 6.6)
Métodos
- void teleport(vector3d position)
Descripción detallada
El tipo CharacterController controla el movimiento de un personaje.
Un personaje es una entidad que se mueve bajo control externo, pero que sigue estando limitada por barreras físicas y (opcionalmente) sujeta a la gravedad. Esto contrasta con los objetos de control de movimiento ( dynamic rigid bodies ), que o bien están controlados por completo por la simulación física (en el caso de los cuerpos no cinemáticos), o bien se mueven exactamente donde se colocan, independientemente de las barreras (en el caso de los objetos cinemáticos).
Para controlar el movimiento de un controlador de personaje, configura « movement » con la velocidad deseada.
En una vista en primera persona, la cámara suele colocarse dentro de un controlador de personaje.
Nota: « collisionShapes » debe configurarse con una única « CapsuleShape ». No se admiten otras formas.
Nota: El controlador de personaje es capaz de escalar obstáculos cuya altura sea inferior a una cuarta parte de la altura de la forma de cápsula.
Véase también «Qt Quick: Formas, cuerpos y articulaciones de física 3D».
Documentación de propiedades
collisions : Collisions [read-only]
Esta propiedad contiene el estado actual de colisión del personaje. Puede ser « None » (sin colisión) o una combinación mediante la operación OR de « Side », « Up » y « Down »:
| Constante | Descripción |
|---|---|
CharacterController.None | El personaje no está tocando nada. Si la gravedad no es nula, esto significa que el personaje está en caída libre. |
CharacterController.Side | El personaje está tocando algo a su lado. |
CharacterController.Up | El personaje está en contacto con algo situado por encima de él. |
CharacterController.Down | El personaje está tocando algo que se encuentra por debajo de él. En condiciones de gravedad estándar, esto significa que el personaje está en el suelo. Nota: Las direcciones se definen en relación con la gravedad estándar: |
enableShapeHitCallback : bool [since 6.6]
Esta propiedad activa o desactiva la función de llamada « CharacterController::shapeHit » para este controlador de personaje.
Valor por defecto: false
Esta propiedad se introdujo en Qt 6.6.
gravity : vector3d
Esta propiedad define la aceleración gravitatoria que se aplica al personaje. Para un personaje que camina por el suelo, normalmente debe establecerse en PhysicsWorld.gravity. Un personaje que flota y cuyos movimientos se controlan en tres dimensiones tendrá normalmente una gravedad de (0, 0, 0).
Valor por defecto: (0, 0, 0).
midAirControl : bool
Esta propiedad define si la propiedad « movement » tiene efecto cuando el personaje se encuentra en caída libre. Esto solo es relevante si « gravity » no es nulo. Un valor de « true » significa que el personaje cambiará de dirección en el aire cuando cambie « movement ». Un valor de « false » significa que el personaje continuará por su trayectoria actual hasta que choque contra otro objeto.
Valor por defecto: true
movement : vector3d
Esta propiedad define el movimiento controlado del personaje. Se trata de la velocidad a la que se movería el personaje en ausencia de gravedad y sin interactuar con otros objetos físicos.
Esta propiedad no refleja la velocidad real del personaje. Si el personaje está atascado contra el terreno, puede moverse más lento que la velocidad definida por « movement ». Por el contrario, si el personaje se encuentra en caída libre, puede moverse mucho más rápido.
Valor por defecto: (0, 0, 0)
Documentación de Signal
[since 6.6] shapeHit(PhysicsNode *body, vector3D position, vector3D impulse, vector3D normal)
Esta señal se emite cuando se ha llamado a ` movement ` y ello daría lugar a una colisión con un ` DynamicRigidBody ` o un ` StaticRigidBody `, y ` enableShapeHitCallback ` está establecido en ` true`. Los parámetros ` body`, ` position`, ` impulse ` y ` normal ` contienen el cuerpo, la posición, la fuerza de impulso y la normal del punto de contacto.
Nota: El controlador correspondiente es onShapeHit.
Esta señal se introdujo en Qt 6.6.
Documentación del método
void teleport(vector3d position)
Mueve inmediatamente el personaje a position sin comprobar si hay colisiones. Quien realiza la llamada es responsable de evitar que se solape con objetos estáticos.
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.