Version: 2023.2

Rigidbody.OnCollisionEnter(Collision)

切换到手册

描述

当该碰撞体/刚体已开始接触另一个刚体/碰撞体时,调用 OnCollisionEnter。

与 OnTriggerEnter 相反,OnCollisionEnter 被传入 Collision 类,而不是 Collider。 Collision 类包含有关接触点、冲击速度等的信息。 如果在该函数中没有使用 collisionInfo,则不考虑 collisionInfo 参数,这样可避免不必要的计算。 注意:如果其中一个碰撞体还附加了非运动学刚体,则仅发送 Collision 事件。Collision 事件将发送到已禁用的 MonoBehaviours,以便允许启用 Behaviours,以响应碰撞。

using UnityEngine;
using System.Collections;

public class ExampleClass : MonoBehaviour { AudioSource audioSource;

void Start() { audioSource = GetComponent<AudioSource>(); }

void OnCollisionEnter(Collision collision) { // Debug-draw all contact points and normals foreach (ContactPoint contact in collision.contacts) { Debug.DrawRay(contact.point, contact.normal, Color.white); }

// Play a sound if the colliding objects had a big impact. if (collision.relativeVelocity.magnitude > 2) audioSource.Play(); } }

另一个示例:

// A grenade
// instantiates a explosion Prefab when hitting a surface
// then destroys itself
using UnityEngine;
using System.Collections;

public class ExampleClass : MonoBehaviour { public Transform explosionPrefab; void OnCollisionEnter(Collision collision) { ContactPoint contact = collision.contacts[0];

// Rotate the object so that the y-axis faces along the normal of the surface Quaternion rot = Quaternion.FromToRotation(Vector3.up, contact.normal); Vector3 pos = contact.point; Instantiate(explosionPrefab, pos, rot); Destroy(gameObject); } }