版本:Unity 6 (6000.0)
语言English
  • C#

Rigidbody2D.GetContacts

建议更改

成功!

感谢您帮助我们提升 Unity 文档的质量。虽然我们无法接受所有提交的内容,但我们会仔细阅读用户提出的每一处建议,并在合适之处进行更新。

关闭

提交失败

出于某种原因,您建议的更改无法提交。请在几分钟后<a>重试</a>。感谢您花时间帮助我们提升 Unity 文档的质量。

关闭

取消

声明

public int GetContacts(ContactPoint2D[] contacts);

参数

contacts 用于接收结果的 ContactPoint2D 数组。

返回值

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

描述

检索附加到此 Rigidbody 的所有碰撞器的所有接触点。

涉及设置为触发器的 Collider2D 的接触将不会在此处返回,因为触发器碰撞器没有接触点。

检索接触时,您应该确保所提供的数组足够大,可以包含您感兴趣的所有接触。通常,数组将被重用,因此其大小应足够返回合理数量的接触。此函数还意味着不会发生任何分配,这意味着无需为垃圾回收器产生任何工作。

其他资源:Collider2D.GetContactsPhysics2D.GetContacts


声明

public int GetContacts(Collider2D[] colliders);

参数

colliders 用于接收结果的 Collider2D 数组。

返回值

int 返回 colliders 数组中放置的碰撞器数量。

描述

检索与附加到此 Rigidbody 的任何碰撞器接触的所有碰撞器。

检索接触时,您应该确保所提供的数组足够大,可以包含您感兴趣的所有接触。通常,数组将被重用,因此其大小应足够返回合理数量的接触。此函数还意味着不会发生任何分配,这意味着无需为垃圾回收器产生任何工作。

其他资源:Collider2D.GetContactsPhysics2D.GetContacts


声明

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

参数

contactFilter 用于对结果进行不同筛选(例如,按图层遮罩、Z 深度或法线角度)的接触筛选器。
contacts 用于接收结果的 ContactPoint2D 数组。

返回值

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

描述

根据 ContactFilter2D 过滤结果,检索附加到此 Rigidbody 的所有碰撞器的所有接触点。

涉及设置成触发器的 Collider2D 的接触永远不会在这里返回,因为触发器碰撞器没有接触点。即使 contactFilter 已将其 ContactFilter2D.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 列表中的接触数。

描述

检索附加到此 Rigidbody 的所有碰撞器的所有接触点。

涉及设置为触发器的 Collider2D 的接触将不会在此处返回,因为触发器碰撞器没有接触点。

整型返回值是写入到 contacts 列表中的结果数量。如果不包含足以报告所有结果的元素,则 contacts 列表将会调整大小。这样做可以防止在 contacts 列表不需要调整大小时为结果分配内存,并且在频繁执行查询时提升垃圾回收利用率。

其他资源:Collider2D.GetContactsPhysics2D.GetContacts


声明

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

参数

contactFilter 用于对结果进行不同筛选(例如,按图层遮罩、Z 深度或法线角度)的接触筛选器。
contacts 用于接收结果的 ContactPoint2D 列表。

返回值

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

描述

检索附加到此 Rigidbody 的所有碰撞器的所有接触点。

涉及设置为触发器的 Collider2D 的接触将不会在此处返回,因为触发器碰撞器没有接触点。

整型返回值是写入到 contacts 列表中的结果数量。如果不包含足以报告所有结果的元素,则 contacts 列表将会调整大小。这样做可以防止在 contacts 列表不需要调整大小时为结果分配内存,并且在频繁执行查询时提升垃圾回收利用率。

还可以使用 contactFilter 来筛选结果。

其他资源:Collider2D.GetContactsPhysics2D.GetContacts


声明

public int GetContacts(List<Collider2D> colliders);

参数

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

返回值

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

描述

检索与附加到此 Rigidbody 的任何碰撞器接触的所有碰撞器。

整型返回值是写入到 colliders 列表中的结果数量。如果不包含足以报告所有结果的元素,则 contacts 列表将会调整大小。这样做可以防止在 colliders 列表不需要调整大小时为结果分配内存,并且在频繁执行查询时提升垃圾回收利用率。

其他资源:Collider2D.GetContactsPhysics2D.GetContacts


声明

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

参数

contactFilter 用于对结果进行不同筛选(例如,按图层遮罩、Z 深度或法线角度)的接触筛选器。
colliders 用于接收结果的 Collider2D 列表。

返回值

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

描述

检索与附加到此 Rigidbody 的任何碰撞器接触的所有碰撞器。

整型返回值是写入到 colliders 列表中的结果数量。如果不包含足以报告所有结果的元素,則 contacts 列表將會調整大小。这样做可以防止在 colliders 列表不需要调整大小时为结果分配内存,并且在频繁执行查询时提升垃圾回收利用率。

还可以使用 contactFilter 来筛选结果。

其他资源:Collider2D.GetContactsPhysics2D.GetContacts