Version: 2019.4
语言: 中文

Physics2D.GetContacts

切换到手册
public static int GetContacts (Collider2D collider, Collider2D[] colliders);

参数

collider要检索其接触点的碰撞体。
colliders用于获取这些结果的 Collider2D 数组。

返回

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

描述

获取与 collider 接触的所有碰撞体。

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

另请参阅：Collider2D.GetContacts 和 Rigidbody2D.GetContacts。

public static int GetContacts (Collider2D collider, ContactPoint2D[] contacts);

参数

collider要检索其接触点的碰撞体。
contacts用于获取这些结果的 ContactPoint2D 数组。

返回

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

描述

获取与 collider 接触的所有接触点。

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

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

另请参阅：Collider2D.GetContacts 和 Rigidbody2D.GetContacts。

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

参数

collider要检索其接触点的碰撞体。
contactFilter接触筛选器，用于以不同方式筛选结果，例如按层遮罩、Z 深度或法线角度。
contacts用于获取这些结果的 ContactPoint2D 数组。

返回

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

描述

获取与 collider 接触的所有接触点，其结果按 ContactFilter2D 进行筛选。

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

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

另请参阅：Collider2D.GetContacts 和 Rigidbody2D.GetContacts。

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

参数

collider要检索其接触点的碰撞体。
contactFilter接触筛选器，用于以不同方式筛选结果，例如按层遮罩、Z 深度或法线角度。
colliders用于获取这些结果的 Collider2D 数组。

返回

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

描述

获取与 collider 接触的所有碰撞体，其结果按 ContactFilter2D 进行筛选。

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

另请参阅：Collider2D.GetContacts 和 Rigidbody2D.GetContacts。

public static int GetContacts (Collider2D collider1, Collider2D collider2, ContactFilter2D contactFilter, ContactPoint2D[] contacts);

参数

collider1用于检查是否与 collider2 接触的碰撞体。
collider2用于检查是否与 collider1 接触的碰撞体。
contactFilter接触筛选器，用于以不同方式筛选结果，例如按层遮罩、Z 深度或法线角度。
contacts用于获取这些结果的 ContactPoint2D 数组。

返回

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

描述

获取 collider1 与 collider2 之间的接触的所有接触点，其结果按 ContactFilter2D 进行筛选。

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

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

另请参阅：Collider2D.GetContacts 和 Rigidbody2D.GetContacts。

public static int GetContacts (Rigidbody2D rigidbody, ContactPoint2D[] contacts);

参数

rigidbody要检索其接触点的刚体。将检查附加到该刚体的所有碰撞体。
contacts用于获取这些结果的 ContactPoint2D 数组。

返回

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

描述

检索与附加到该刚体的任何碰撞体接触的所有接触点。

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

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

另请参阅：Collider2D.GetContacts 和 Rigidbody2D.GetContacts。

public static int GetContacts (Rigidbody2D rigidbody, Collider2D[] colliders);

参数

rigidbody要检索其接触点的刚体。将检查附加到该刚体的所有碰撞体。
colliders用于获取这些结果的 Collider2D 数组。

返回

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

描述

检索与附加到该刚体的任何碰撞体接触的所有碰撞体。

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

另请参阅：Collider2D.GetContacts 和 Rigidbody2D.GetContacts。

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

参数

rigidbody要检索其接触点的刚体。将检查附加到该刚体的所有碰撞体。
contactFilter接触筛选器，用于以不同方式筛选结果，例如按层遮罩、Z 深度或法线角度。
contacts用于获取这些结果的 ContactPoint2D 数组。

返回

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

描述

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

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

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

另请参阅：Collider2D.GetContacts 和 Rigidbody2D.GetContacts。

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

参数

rigidbody要检索其接触点的刚体。将检查附加到该刚体的所有碰撞体。
contactFilter接触筛选器，用于以不同方式筛选结果，例如按层遮罩、Z 深度或法线角度。
colliders用于获取这些结果的 Collider2D 数组。

返回

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

描述

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

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

另请参阅：Collider2D.GetContacts 和 Rigidbody2D.GetContacts。

public static int GetContacts (Collider2D collider, List<Collider2D> colliders);

参数

collider要获取其接触点的碰撞体。
colliders用于接收结果的 Collider2D 列表。

返回

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

描述

获取与 collider 接触的所有碰撞体。

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

另请参阅：Collider2D.GetContacts 和 Rigidbody2D.GetContacts。

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

参数

collider要获取其接触点的碰撞体。
contactFilter接触筛选器，用于以不同方式筛选结果，例如按层遮罩、Z 深度或法线角度。
colliders用于接收结果的 Collider2D 列表。

返回

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

描述

获取与 collider 接触的所有碰撞体，其结果按 contactFilter2D 进行筛选。

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

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

另请参阅：Collider2D.GetContacts 和 Rigidbody2D.GetContacts。

public static int GetContacts (Collider2D collider, List<ContactPoint2D> contacts);

参数

collider要获取其接触点的碰撞体。
contacts用于接收结果的 ContactPoint2D 列表。

返回

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

描述

获取与 collider 接触的所有接触点。

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

另请参阅：Collider2D.GetContacts 和 Rigidbody2D.GetContacts。

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

参数

collider要获取其接触点的碰撞体。
contactFilter接触筛选器，用于以不同方式筛选结果，例如按层遮罩、Z 深度或法线角度。
contacts用于接收结果的 ContactPoint2D 列表。

返回

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

描述

获取与 collider 接触的所有接触点，其结果按 contactFilter2D 进行筛选。

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

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

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

另请参阅：Collider2D.GetContacts 和 Rigidbody2D.GetContacts。

public static int GetContacts (Collider2D collider1, Collider2D collider2, ContactFilter2D contactFilter, List<ContactPoint2D> contacts);

参数

collider1用于检查是否与 collider2 接触的碰撞体。
collider2用于检查是否与 collider1 接触的碰撞体。
contactFilter接触筛选器，用于以不同方式筛选结果，例如按层遮罩、Z 深度或法线角度。
contacts用于接收结果的 ContactPoint2D 列表。

返回

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

描述

获取 collider1 与 collider2 之间的接触的所有接触点，其结果按 contactFilter2D 进行筛选。

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

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

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

另请参阅：Collider2D.GetContacts 和 Rigidbody2D.GetContacts。

public static int GetContacts (Rigidbody2D rigidbody, List<Collider2D> colliders);

参数

rigidbody要获取其接触点的刚体。将检查附加到刚体的所有碰撞体。
colliders用于接收结果的 Collider2D 列表。

返回

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

描述

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

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

另请参阅：Collider2D.GetContacts 和 Rigidbody2D.GetContacts。

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

参数

rigidbody要获取其接触点的刚体。将检查附加到刚体的所有碰撞体。
contactFilter接触筛选器，用于以不同方式筛选结果，例如按层遮罩、Z 深度或法线角度。
colliders用于接收结果的 Collider2D 列表。

返回

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

描述

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

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

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

另请参阅：Collider2D.GetContacts 和 Rigidbody2D.GetContacts。

public static int GetContacts (Rigidbody2D rigidbody, List<ContactPoint2D> contacts);

参数

rigidbody要获取其接触点的刚体。将检查附加到刚体的所有碰撞体。
contacts用于接收结果的 ContactPoint2D 列表。

返回

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

描述

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

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

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

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

另请参阅：Collider2D.GetContacts 和 Rigidbody2D.GetContacts。

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

参数

rigidbody要获取其接触点的刚体。将检查附加到刚体的所有碰撞体。
contactFilter返回放置在 contacts 列表中的接触点数。
contacts用于接收结果的 ContactPoint2D 列表。

返回

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

描述

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

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

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

另请参阅：Collider2D.GetContacts 和 Rigidbody2D.GetContacts。

Copyright © 2023 Unity Technologies
优美缔软件（上海）有限公司 版权所有
"Unity"、Unity 徽标及其他 Unity 商标是 Unity Technologies 或其附属机构在美国及其他地区的商标或注册商标。其他名称或品牌是其各自所有者的商标。
公安部备案号:
31010902002961