Collider2D.GetContacts

# [Collider2D](https://docs.unity3d.com/cn/2019.4/ScriptReference/Collider2D.html).GetContacts

public int **GetContacts** (ContactPoint2D[] **contacts**);

## 参数

| contacts | 用于获取这些结果的 [ContactPoint2D](https://docs.unity3d.com/cn/2019.4/ScriptReference/ContactPoint2D.html) 数组。 |
| ---------- | ----------------------------------------------------------------------------------------------------------------- |

## 返回

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

## 描述

获取此碰撞体的所有接触点。

如果接触点涉及被设置为触发器的 [Collider2D](https://docs.unity3d.com/cn/2019.4/ScriptReference/Collider2D.html)，则这里不会返回这些接触点，因为触发碰撞体没有接触点。

您应传入一个大到足以包含您想要返回的所有接触的数组。这个数组一般会被重用，因此其大小应能够返回合理数量的接触。此函数不进行分配，这意味着不需要垃圾回收器进行回收。

另请参阅：[Rigidbody2D.GetContacts](https://docs.unity3d.com/cn/2019.4/ScriptReference/Rigidbody2D.GetContacts.html) 和 [Physics2D.GetContacts](https://docs.unity3d.com/cn/2019.4/ScriptReference/Physics2D.GetContacts.html)。

---

public int **GetContacts** (Collider2D[] **colliders**);

## 参数

| colliders | 用于获取这些结果的 [Collider2D](https://docs.unity3d.com/cn/2019.4/ScriptReference/Collider2D.html) 数组。 |
| ----------- | --------------------------------------------------------------------------------------------------------- |

## 返回

**int** 返回放置在 `colliders` 数组中的接触数。

## 描述

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

您应传入一个大到足以包含您想要返回的所有接触的数组。这个数组一般会被重用，因此其大小应能够返回合理数量的接触。此函数不进行分配，这意味着不需要垃圾回收器进行回收。

另请参阅：[Rigidbody2D.GetContacts](https://docs.unity3d.com/cn/2019.4/ScriptReference/Rigidbody2D.GetContacts.html) 和 [Physics2D.GetContacts](https://docs.unity3d.com/cn/2019.4/ScriptReference/Physics2D.GetContacts.html)。

---

public int **GetContacts** ([ContactFilter2D](https://docs.unity3d.com/cn/2019.4/ScriptReference/ContactFilter2D.html) **contactFilter**, ContactPoint2D[] **contacts**);

## 参数

| contactFilter | 接触筛选器，用于以不同方式筛选结果，例如按层遮罩、Z 深度或法线角度。                                            |
| --------------- | ----------------------------------------------------------------------------------------------------------------- |
| contacts      | 用于获取这些结果的 [ContactPoint2D](https://docs.unity3d.com/cn/2019.4/ScriptReference/ContactPoint2D.html) 数组。 |

## 返回

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

## 描述

获取此碰撞体的所有接触点，其结果按 `contactFilter` 进行筛选。

如果接触点涉及被设置为触发器的 [Collider2D](https://docs.unity3d.com/cn/2019.4/ScriptReference/Collider2D.html)，则这里不会返回这些接触点，因为触发碰撞体没有接触点。即使 `contactFilter` 的 [ContactFilter2D.useTriggers](https://docs.unity3d.com/cn/2019.4/ScriptReference/ContactFilter2D-useTriggers.html) 设置为 true，也是如此。

您应传入一个大到足以包含您想要返回的所有接触的数组。这个数组一般会被重用，因此其大小应能够返回合理数量的接触。此函数不进行分配，这意味着不需要垃圾回收器进行回收。

另请参阅：[Rigidbody2D.GetContacts](https://docs.unity3d.com/cn/2019.4/ScriptReference/Rigidbody2D.GetContacts.html) 和 [Physics2D.GetContacts](https://docs.unity3d.com/cn/2019.4/ScriptReference/Physics2D.GetContacts.html)。

---

public int **GetContacts** ([ContactFilter2D](https://docs.unity3d.com/cn/2019.4/ScriptReference/ContactFilter2D.html) **contactFilter**, Collider2D[] **colliders**);

## 参数

| contactFilter | 接触筛选器，用于以不同方式筛选结果，例如按层遮罩、Z 深度或法线角度。                                    |
| --------------- | --------------------------------------------------------------------------------------------------------- |
| colliders     | 用于获取这些结果的 [Collider2D](https://docs.unity3d.com/cn/2019.4/ScriptReference/Collider2D.html) 数组。 |

## 返回

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

## 描述

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

您应传入一个大到足以包含您想要返回的所有接触的数组。这个数组一般会被重用，因此其大小应能够返回合理数量的接触。此函数不进行分配，这意味着不需要垃圾回收器进行回收。

另请参阅：[Rigidbody2D.GetContacts](https://docs.unity3d.com/cn/2019.4/ScriptReference/Rigidbody2D.GetContacts.html) 和 [Physics2D.GetContacts](https://docs.unity3d.com/cn/2019.4/ScriptReference/Physics2D.GetContacts.html)。

---

public int **GetContacts** (List<ContactPoint2D> **contacts**);

## 参数

| contacts | 用于接收结果的 [ContactPoint2D](https://docs.unity3d.com/cn/2019.4/ScriptReference/ContactPoint2D.html) 列表。 |
| ---------- | ------------------------------------------------------------------------------------------------------------- |

## 返回

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

## 描述

获取此碰撞体的所有接触点。

如果接触点涉及被设置为触发器的 [Collider2D](https://docs.unity3d.com/cn/2019.4/ScriptReference/Collider2D.html)，则这里不会返回这些接触点，因为触发碰撞体没有接触点。

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

另请参阅：[Rigidbody2D.GetContacts](https://docs.unity3d.com/cn/2019.4/ScriptReference/Rigidbody2D.GetContacts.html) 和 [Physics2D.GetContacts](https://docs.unity3d.com/cn/2019.4/ScriptReference/Physics2D.GetContacts.html)。

---

public int **GetContacts** (List<Collider2D> **colliders**);

## 参数

| colliders | 用于接收结果的 [Collider2D](https://docs.unity3d.com/cn/2019.4/ScriptReference/Collider2D.html) 列表。 |
| ----------- | ----------------------------------------------------------------------------------------------------- |

## 返回

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

## 描述

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

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

另请参阅：[Rigidbody2D.GetContacts](https://docs.unity3d.com/cn/2019.4/ScriptReference/Rigidbody2D.GetContacts.html) 和 [Physics2D.GetContacts](https://docs.unity3d.com/cn/2019.4/ScriptReference/Physics2D.GetContacts.html)。

---

public int **GetContacts** ([ContactFilter2D](https://docs.unity3d.com/cn/2019.4/ScriptReference/ContactFilter2D.html) **contactFilter**, List<ContactPoint2D> **contacts**);

## 参数

| contactFilter | 接触筛选器，用于以不同方式筛选结果，例如按层遮罩、Z 深度或法线角度。                                        |
| --------------- | ------------------------------------------------------------------------------------------------------------- |
| contacts      | 用于接收结果的 [ContactPoint2D](https://docs.unity3d.com/cn/2019.4/ScriptReference/ContactPoint2D.html) 列表。 |

## 返回

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

## 描述

获取此碰撞体的所有接触点，其结果按 `contactFilter` 进行筛选。

如果接触点涉及被设置为触发器的 [Collider2D](https://docs.unity3d.com/cn/2019.4/ScriptReference/Collider2D.html)，则这里不会返回这些接触点，因为触发碰撞体没有接触点。

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

另请参阅：[Rigidbody2D.GetContacts](https://docs.unity3d.com/cn/2019.4/ScriptReference/Rigidbody2D.GetContacts.html) 和 [Physics2D.GetContacts](https://docs.unity3d.com/cn/2019.4/ScriptReference/Physics2D.GetContacts.html)。

---

public int **GetContacts** ([ContactFilter2D](https://docs.unity3d.com/cn/2019.4/ScriptReference/ContactFilter2D.html) **contactFilter**, List<Collider2D> **colliders**);

## 参数

| contactFilter | 接触筛选器，用于以不同方式筛选结果，例如按层遮罩、Z 深度或法线角度。                                |
| --------------- | ----------------------------------------------------------------------------------------------------- |
| colliders     | 用于接收结果的 [Collider2D](https://docs.unity3d.com/cn/2019.4/ScriptReference/Collider2D.html) 列表。 |

## 返回

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

## 描述

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

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

另请参阅：[Rigidbody2D.GetContacts](https://docs.unity3d.com/cn/2019.4/ScriptReference/Rigidbody2D.GetContacts.html) 和 [Physics2D.GetContacts](https://docs.unity3d.com/cn/2019.4/ScriptReference/Physics2D.GetContacts.html)。