fix: provide non Rigidbody contact events and Rigidbody prioritization

[NoelStephensUnity]

This extends the RigidbodyContactEventManager by adding a new interface that provides ContactEventHandlerInfo:

• ContactEventHandlerInfo.ProvideNonRigidBodyContactEvents: When set to true, non-Rigidbody collisions with the registered Rigidbody will generate contact event notifications.

  • If you want a registered Rigidbody to generate contact event notifications when colliding with non-registered objects that just have colliders (i.e. terrain, static world objects, etc.) , then setting this to true will generate contact events.

• ContactEventHandlerInfo.HasContactEventPriority: When set to true, the Rigidbody will be prioritized as the instance that generates the event if the Rigidbody colliding does not have priority.

  • If this value is tied to ownership and a non-kinematic body collides with a kinematic body and the sequence of the collision places the kinematic body first in the contact event processing, then the non-kinematic body will be considered "preferred" when triggering the contact event notification.

The ContactEventHandlerInfo is queried each time there are contact events to be processed.

This addition does not impact any previous configurations/uses of RigidbodyContactEventManager.

MTT-9182

Changelog

• Added IContactEventHandlerWithInfo that derives from IContactEventHandler that can be updated per frame to provide ContactEventHandlerInfo information to the RigidbodyContactEventManager when processing collisions.
  • ContactEventHandlerInfo.ProvideNonRigidBodyContactEvents: When set to true, non-Rigidbody collisions with the registered Rigidbody will generate contact event notifications.
  • ContactEventHandlerInfo.HasContactEventPriority: When set to true, the Rigidbody will be prioritized as the instance that generates the event if the Rigidbody colliding does not have priority.

Testing and Documentation

• Includes integration tests (wip).
• Requires public documentation update (part of Rigidbody pass).
• Includes XML API Documentation additions and updates.