版本:Unity 6 (6000.0)
语言简体中文
  • C#

Collider2D.GetContacts

提出变更

成功!

感谢您帮助我们提高 Unity 文档的质量。虽然我们不能接受所有提交,但我们确实会阅读用户提出的每一项变更建议,并在适用的情况下进行更新。

关闭

提交失败

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

关闭

取消

声明

public int GetContacts(ContactPoint2D[] contacts);

参数

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

返回值

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

描述

检索此碰撞器的所有接触点。

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

您应该传递一个足够大的数组来包含所有要返回的接触点。通常会重用此数组,因此它的维度应该足够大,能够返回合理的接触点数量。此函数中不会发生内存分配,这意味着垃圾回收器不会执行任何工作。

其他资源:Rigidbody2D.GetContactsPhysics2D.GetContacts


声明

public int GetContacts(Collider2D[] colliders);

参数

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

返回值

int 返回置于 colliders 数组中的接触点数量。

描述

获取与碰撞器接触的所有碰撞器。

您应该传递一个足够大的数组来包含所有要返回的接触点。通常会重用此数组,因此它的维度应该足够大,能够返回合理的接触点数量。此函数中不会发生内存分配,这意味着垃圾回收器不会执行任何工作。

其他资源:Rigidbody2D.GetContactsPhysics2D.GetContacts


声明

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

参数

contactFilter 用于按不同的方式(比如按照图层蒙版、Z 深度或法线角度)筛选结果的接触过滤器。
contacts 用于接收结果的 ContactPoint2D 数组。

返回值

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

描述

获取此碰撞器的所有接触点,其中结果通过 contactFilter 筛选。

涉及被设为触发器的 Collider2D 的接触点永远不会在此处返回,因为触发碰撞器没有接触点。即使 contactFilterContactFilter2D.useTriggers 设置为 true,此规则也成立。

您应该传递一个足够大的数组来包含所有要返回的接触点。通常会重用此数组,因此它的维度应该足够大,能够返回合理的接触点数量。此函数中不会发生内存分配,这意味着垃圾回收器不会执行任何工作。

其他资源:Rigidbody2D.GetContactsPhysics2D.GetContacts


声明

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

参数

contactFilter 用于按不同的方式(比如按照图层蒙版、Z 深度或法线角度)筛选结果的接触过滤器。
colliders 用于接收结果的 Collider2D 数组。

返回值

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

描述

获取与这个碰撞器接触的所有碰撞器,其结果通过 contactFilter 进行过滤。

您应该传递一个足够大的数组来包含所有要返回的接触点。通常会重用此数组,因此它的维度应该足够大,能够返回合理的接触点数量。此函数中不会发生内存分配,这意味着垃圾回收器不会执行任何工作。

其他资源:Rigidbody2D.GetContactsPhysics2D.GetContacts


声明

public int GetContacts(List<ContactPoint2D> contacts);

参数

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

返回值

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

描述

检索此碰撞器的所有接触点。

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

如果结果列表不包含足够的元素来报告所有结果,那么将重新设置大小。这可防止在不需要重新设置 results 列表大小时为结果分配内存,并在频繁执行查询时提高垃圾回收性能。

其他资源:Rigidbody2D.GetContactsPhysics2D.GetContacts


声明

public int GetContacts(List<Collider2D> colliders);

参数

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

返回值

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

描述

获取与碰撞器接触的所有碰撞器。

如果结果列表不包含足够的元素来报告所有结果,那么将重新设置大小。这可防止在不需要重新设置 results 列表大小时为结果分配内存,并在频繁执行查询时提高垃圾回收性能。

其他资源:Rigidbody2D.GetContactsPhysics2D.GetContacts


声明

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

参数

contactFilter 用于按不同的方式(比如按照图层蒙版、Z 深度或法线角度)筛选结果的接触过滤器。
contacts 用于接收结果的 ContactPoint2D 列表。

返回值

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

描述

获取此碰撞器的所有接触点,其中结果通过 contactFilter 筛选。

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

如果结果列表不包含足够的元素来报告所有结果,那么将重新设置大小。这可防止在不需要重新设置 results 列表大小时为结果分配内存,并在频繁执行查询时提高垃圾回收性能。

其他资源:Rigidbody2D.GetContactsPhysics2D.GetContacts


声明

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

参数

contactFilter 用于按不同的方式(比如按照图层蒙版、Z 深度或法线角度)筛选结果的接触过滤器。
colliders 用于接收结果的 Collider2D 列表。

返回值

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

描述

获取与这个碰撞器接触的所有碰撞器,其结果通过 contactFilter 进行过滤。

如果结果列表不包含足够的元素来报告所有结果,那么将重新设置大小。这可防止在不需要重新设置 results 列表大小时为结果分配内存,并在频繁执行查询时提高垃圾回收性能。

其他资源:Rigidbody2D.GetContactsPhysics2D.GetContacts