Version: 2021.3
public int GetContacts (ContactPoint2D[] contacts);

参数

contacts 用于获取这些结果的 ContactPoint2D 数组。

返回

int 返回放置在 contacts 数组中的接触数。

描述

获取附加到该刚体的所有碰撞体的所有接触点。

如果接触点涉及被设置为触发器的 Collider2D,则这里不会返回这些接触点,因为触发碰撞体没有接触点。

当获取接触时,应确保提供的数组足够大,能够包含您感兴趣的所有接触。该数组一般会重用,因此其大小应能够返回合理数量的接触。此函数还意味着不发生分配,因此不需要垃圾回收器进行回收。

另请参阅:Collider2D.GetContactsPhysics2D.GetContacts


public int GetContacts (Collider2D[] colliders);

参数

colliders 用于获取这些结果的 Collider2D 数组。

返回

int 返回放置在 colliders 数组中的碰撞体数。

描述

获取与附加到刚体的任何碰撞体接触的所有碰撞体。

当获取接触时,应确保提供的数组足够大,能够包含您感兴趣的所有接触。该数组一般会重用,因此其大小应能够返回合理数量的接触。此函数还意味着不发生分配,因此不需要垃圾回收器进行回收。

另请参阅:Collider2D.GetContactsPhysics2D.GetContacts


public int GetContacts (ContactFilter2D contactFilter, ContactPoint2D[] contacts);

参数

contactFilter 接触筛选器,用于以不同方式筛选结果,例如按层遮罩、Z 深度或法线角度。
contacts 用于获取这些结果的 ContactPoint2D 数组。

返回

int 返回放置在 contacts 数组中的接触数。

描述

获取附加到该刚体的所有碰撞体的所有接触点,其结果按 ContactFilter2D 进行筛选。

如果接触点涉及被设置为触发器的 Collider2D,则这里不会返回这些接触点,因为触发碰撞体没有接触点。即使 contactFilterContactFilter2D.useTriggers 设置为 true,也是如此。

当获取接触时,应确保提供的数组足够大,能够包含您感兴趣的所有接触。该数组一般会重用,因此其大小应能够返回合理数量的接触。此函数还意味着不发生分配,因此不需要垃圾回收器进行回收。

另请参阅:Collider2D.GetContactsPhysics2D.GetContacts


public int GetContacts (ContactFilter2D contactFilter, Collider2D[] colliders);

参数

contactFilter 接触筛选器,用于以不同方式筛选结果,例如按层遮罩、Z 深度或法线角度。
colliders 用于获取这些结果的 Collider2D 数组。

返回

int 返回放置在 colliders 数组中的碰撞体数。

描述

获取与附加到刚体的任何碰撞体接触的所有碰撞体,其结果按 ContactFilter2D 进行筛选。

当获取接触时,应确保提供的数组足够大,能够包含您感兴趣的所有接触。该数组一般会重用,因此其大小应能够返回合理数量的接触。此函数还意味着不发生分配,因此不需要垃圾回收器进行回收。

另请参阅:Collider2D.GetContactsPhysics2D.GetContacts


public int GetContacts (List<ContactPoint2D> contacts);

参数

contacts 用于接收结果的 ContactPoint2D 列表。

返回

int 返回放置在 contacts 列表中的接触点数。

描述

获取附加到该刚体的所有碰撞体的所有接触点。

如果接触点涉及被设置为触发器的 Collider2D,则这里不会返回这些接触点,因为触发碰撞体没有接触点。

该整数返回值是写入到 contacts 列表中的结果数。如果接触列表中没有足够的元素来报告所有这些结果,则会调整列表的大小。这可在 contacts 列表无需调整大小时防止为结果分配内存,可在经常执行查询时提高垃圾收集性能。

另请参阅:Collider2D.GetContactsPhysics2D.GetContacts


public int GetContacts (ContactFilter2D contactFilter, List<ContactPoint2D> contacts);

参数

contactFilter 接触筛选器,用于以不同方式筛选结果,例如按层遮罩、Z 深度或法线角度。
contacts 用于接收结果的 ContactPoint2D 列表。

返回

int 返回放置在 contacts 列表中的接触点数。

描述

获取附加到该刚体的所有碰撞体的所有接触点。

如果接触点涉及被设置为触发器的 Collider2D,则这里不会返回这些接触点,因为触发碰撞体没有接触点。

该整数返回值是写入到 contacts 列表中的结果数。如果接触列表中没有足够的元素来报告所有这些结果,则会调整列表的大小。这可在 contacts 列表无需调整大小时防止为结果分配内存,可在经常执行查询时提高垃圾收集性能。

也可以通过 contactFilter 对结果进行筛选。

另请参阅:Collider2D.GetContactsPhysics2D.GetContacts


public int GetContacts (List<Collider2D> colliders);

参数

colliders 用于接收结果的 Collider2D 列表。

返回

int 返回放置在 colliders 列表中的碰撞体数。

描述

获取与附加到刚体的任何碰撞体接触的所有碰撞体。

该整数返回值是写入到 colliders 列表中的结果数。如果接触列表中没有足够的元素来报告所有这些结果,则会调整列表的大小。这可在 colliders 列表无需调整大小时防止为结果分配内存,可在经常执行查询时提高垃圾收集性能。

另请参阅:Collider2D.GetContactsPhysics2D.GetContacts


public int GetContacts (ContactFilter2D contactFilter, List<Collider2D> colliders);

参数

contactFilter 接触筛选器,用于以不同方式筛选结果,例如按层遮罩、Z 深度或法线角度。
colliders 用于接收结果的 Collider2D 列表。

返回

int 返回放置在 colliders 列表中的碰撞体数。

描述

获取与附加到刚体的任何碰撞体接触的所有碰撞体。

该整数返回值是写入到 colliders 列表中的结果数。如果接触列表中没有足够的元素来报告所有这些结果,则会调整列表的大小。这可在 colliders 列表无需调整大小时防止为结果分配内存,可在经常执行查询时提高垃圾收集性能。

也可以通过 contactFilter 对结果进行筛选。

另请参阅:Collider2D.GetContactsPhysics2D.GetContacts