Qt Quick Cambios en la API de física 3D con respecto a la versión Tech Preview

A partir de la versión Qt 6.5.0, el módulo de física 3D de Qt Quick ya no se encuentra en fase de Tech Preview. Como resultado del proceso de revisión y comentarios sobre la API, se han realizado algunos cambios incompatibles con el código fuente.

La mayoría de los cambios consisten en renombrar tipos y propiedades para mantener la coherencia con otras API y para que los nombres sean más descriptivos. El cambio de nombre más notable es el de « DynamicsWorld » a « PhysicsWorld », lo que afectará a todas las aplicaciones.

El cambio de comportamiento más importante es el manejo de « kinematic bodies ». El cambio de posición u orientación de un cuerpo cinemático ya no se realiza mediante las propiedades de « Node » (position, rotation, etc.), sino mediante las nuevas propiedades: kinematicPosition, kinematicEulerRotation, kinematicRotation y kinematicPivot. El motivo de este cambio fue garantizar que el movimiento visual de los cuerpos cinemáticos se sincronizara con el resto de la simulación, en lugar de producirse un paso de simulación antes de lo previsto.

La propiedad ` DynamicRigidBody.density ` ya no trata los valores negativos (ni el cero) como un caso especial. En su lugar, hay dos nuevos valores de enumeración ` massMode ` que sustituyen a ` Density`:

DefaultDensityLa densidad del cuerpo viene definida por PhysicsWorld.defaultDensity. Este es el valor por defecto.
CustomDensityLa densidad del cuerpo viene definida por la propiedad « density ».

La propiedad « enableTriggerReports » ha pasado a denominarse « sendTriggerReports ». Además, ahora se puede notificar a los objetos físicos cuando entran en un cuerpo de activación estableciendo « receiveTriggerReports ».

A continuación se incluye una lista completa de todos los cambios en la API:

© 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.