Version: 2022.3
语言: 中文

Physics2D.GetContacts

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

参数

Collider 要获取其接触点的碰撞体。
Colliders 用于获取这些结果的 Collider2D 数组。

返回

int Returns the number of Colliders placed in the Colliders array.

描述

Retrieves all Colliders in contact with the Collider.

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

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

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

参数

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

返回

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

描述

Retrieves all contact points in contact with the Collider.

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

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

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

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

参数

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

返回

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

描述

Retrieves all contact points in contact with the Collider, with the results filtered by the 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 Returns the number of Colliders placed in the Colliders array.

描述

Retrieves all Colliders in contact with the Collider, with the results filtered by the 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 The rigidbody to retrieve contacts for. All Colliders attached to this rigidbody will be checked.
contacts 用于获取这些结果的 ContactPoint2D 数组。

返回

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

描述

Retrieves all contact points in contact with any of the Collider(s) attached to this rigidbody.

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

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

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

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

参数

rigidbody The rigidbody to retrieve contacts for. All Colliders attached to this rigidbody will be checked.
Colliders 用于获取这些结果的 Collider2D 数组。

返回

int Returns the number of Colliders placed in the Colliders array.

描述

Retrieves all Colliders in contact with any of the Collider(s) attached to this rigidbody.

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

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

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

参数

rigidbody The rigidbody to retrieve contacts for. All Colliders attached to this rigidbody will be checked.
contactFilter 接触筛选器，用于以不同方式筛选结果，例如按层遮罩、Z 深度或法线角度。
contacts 用于获取这些结果的 ContactPoint2D 数组。

返回

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

描述

Retrieves all contact points in contact with any of the Collider(s) attached to this rigidbody, with the results filtered by the ContactFilter2D.

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

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

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

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

参数

rigidbody The rigidbody to retrieve contacts for. All Colliders attached to this rigidbody will be checked.
contactFilter 接触筛选器，用于以不同方式筛选结果，例如按层遮罩、Z 深度或法线角度。
Colliders 用于获取这些结果的 Collider2D 数组。

返回

int Returns the number of Colliders placed in the Colliders array.

描述

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

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

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

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

参数

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

返回

int Returns the number of Colliders placed in the Colliders list.

描述

Retrieves all Colliders in contact with the Collider.

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

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

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

参数

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

返回

int Returns the number of Colliders placed in the Colliders list.

描述

Retrieves all Colliders in contact with the Collider, with the results filtered by the contactFilter2D.

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

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

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

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

参数

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

返回

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

描述

Retrieves all contact points in contact with the 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 列表中的接触点数。

描述

Retrieves all contact points in contact with the Collider, with the results filtered by the 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 Returns the number of Colliders placed in the Colliders list.

描述

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

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

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

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

参数

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

返回

int Returns the number of Colliders placed in the Colliders list.

描述

获取与附加到刚体的任何碰撞体接触的所有碰撞体，其结果按 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