OnCollisionEnter

Lorsque deux collisionneurs commencent à se toucher, Unity appelle OnCollisionEnter(Collision collision) dans les scripts des deux objets. Cette méthode est appelée une seule fois, lors de l’étape de physique où le contact commence, et pas de nouveau tant qu’ils restent en contact. Pour qu’une collision se produise, au moins l’un des deux objets doit avoir un Rigidbody que la physique déplace : un mur et un sol sans Rigidbody ne se signalent jamais rien l’un à l’autre.

Cette caisse consigne un message lorsqu’elle atterrit. Elle possède un Rigidbody, donc elle tombe, et le message est envoyé à l’étape où elle rencontre le sol :

void OnCollisionEnter(Collision collision)
{
    Debug.Log("Thud!");
}

La caisse consigne un message une fois, puis seulement après avoir quitté le sol et y avoir atterri une deuxième fois. Le sol reçoit aussi le message : un script qui s’y trouve détecterait l’atterrissage de la caisse, même si le sol n’a pas de Rigidbody. Le nom et le paramètre doivent être exacts. Une méthode nommée onCollisionEnter n’est jamais appelée, sans qu’aucune erreur ne soit signalée. Si une méthode prend un Collider, Unity consigne Script error: OnCollisionEnter avec This message parameter has to be of type: Collision, puis l’ignore. Tant que les deux objets restent en contact, Unity appelle OnCollisionStay à chaque étape de physique et, lorsqu’ils se séparent, appelle une fois OnCollisionExit.