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

Physics2D.GetContacts

反馈
建议更改

成功！

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

关闭

提交失败

由于某种原因，您的建议更改无法提交。请<a>稍后再试</a>。感谢您花时间帮助我们提高 Unity 文档的质量。

关闭

取消

声明

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

参数

碰撞体 要检索碰撞体的碰撞体。
碰撞体 用于接收结果的 Collider2D 数组。

返回值

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

描述

检索与 Collider 接触的所有碰撞体。

检索碰撞体时，您应确保提供的数组足够大，可以容纳您感兴趣的所有碰撞体。通常，该数组会被重复使用，因此它的大小会返回合理数量的碰撞体。此函数还意味着不会发生任何分配，这意味着不会为垃圾回收器产生任何工作。

其他资源：Collider2D.GetContacts 和 Rigidbody2D.GetContacts。

声明

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

参数

碰撞体 要检索碰撞体的碰撞体。
contacts 用于接收结果的 ContactPoint2D 数组。

返回值

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

描述

检索与 Collider 接触的所有接触点。

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

检索碰撞体时，您应确保提供的数组足够大，可以容纳您感兴趣的所有碰撞体。通常，该数组会被重复使用，因此它的大小会返回合理数量的碰撞体。此函数还意味着不会发生任何分配，这意味着不会为垃圾回收器产生任何工作。

其他资源：Collider2D.GetContacts 和 Rigidbody2D.GetContacts。

声明

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

参数

碰撞体 要检索碰撞体的碰撞体。
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);

参数

碰撞体 要检索碰撞体的碰撞体。
contactFilter 用于以不同方式过滤结果的接触过滤器，例如按图层蒙版、Z 深度或法线角度。
碰撞体 用于接收结果的 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 要检索碰撞体的刚体。将检查附加到此刚体的所有碰撞体。
碰撞体 用于接收结果的 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 深度或法线角度。
碰撞体 用于接收结果的 Collider2D 数组。

返回值

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

描述

检索与附加到此刚体的任何碰撞体接触的所有碰撞体，结果由 ContactFilter2D 过滤。

检索碰撞体时，您应确保提供的数组足够大，可以容纳您感兴趣的所有碰撞体。通常，该数组会被重复使用，因此它的大小会返回合理数量的碰撞体。此函数还意味着不会发生任何分配，这意味着不会为垃圾回收器产生任何工作。

其他资源：Collider2D.GetContacts 和 Rigidbody2D.GetContacts。

声明

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

参数

碰撞体 要检索碰撞体的碰撞体。
碰撞体 用于接收结果的 Collider2D 列表。

返回值

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

描述

检索与 Collider 接触的所有碰撞体。

整数返回值是写入 results 列表的结果数量。如果 results 列表不包含足够元素来报告所有结果，则该列表将被调整大小。这可以防止在不需要调整 results 列表大小时分配结果的内存，并在频繁执行查询时提高垃圾回收性能。

其他资源：Collider2D.GetContacts 和 Rigidbody2D.GetContacts。

声明

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

参数

碰撞体 要检索碰撞体的碰撞体。
contactFilter 用于以不同方式过滤结果的接触过滤器，例如按图层蒙版、Z 深度或法线角度。
碰撞体 用于接收结果的 Collider2D 列表。

返回值

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

描述

检索与 Collider 接触的所有碰撞体，结果由 contactFilter2D 过滤。

整数返回值是写入 results 列表的结果数量。如果 results 列表不包含足够元素来报告所有结果，则该列表将被调整大小。这可以防止在不需要调整 results 列表大小时分配结果的内存，并在频繁执行查询时提高垃圾回收性能。

结果也可以由 contactFilter 过滤。

其他资源：Collider2D.GetContacts 和 Rigidbody2D.GetContacts。

声明

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

参数

碰撞体 要检索碰撞体的碰撞体。
contacts 用于接收结果的 ContactPoint2D 列表。

返回值

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

描述

检索与 Collider 接触的所有接触点。

整数返回值是写入 results 列表的结果数量。如果 results 列表不包含足够元素来报告所有结果，则该列表将被调整大小。这可以防止在不需要调整 results 列表大小时分配结果的内存，并在频繁执行查询时提高垃圾回收性能。

其他资源：Collider2D.GetContacts 和 Rigidbody2D.GetContacts。

声明

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

参数

碰撞体 要检索碰撞体的碰撞体。
contactFilter 用于以不同方式过滤结果的接触过滤器，例如按图层蒙版、Z 深度或法线角度。
contacts 用于接收结果的 ContactPoint2D 列表。

返回值

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

描述

检索与 Collider 接触的所有接触点，结果由 contactFilter2D 过滤。

涉及设置为触发器的 Collider2D 的接触点永远不会在此处返回，因为触发器碰撞体没有接触点。即使 contactFilter 的 ContactFilter2D.useTriggers 设置为 true，也是如此。

整数返回值是写入 results 列表的结果数量。如果 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 列表不包含足够元素来报告所有结果，则该列表将被调整大小。这可以防止在不需要调整 results 列表大小时分配结果的内存，并在频繁执行查询时提高垃圾回收性能。

结果也可以由 contactFilter 过滤。

其他资源：Collider2D.GetContacts 和 Rigidbody2D.GetContacts。

声明

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

参数

rigidbody 要检索碰撞体的刚体。将检查附加到此刚体的所有碰撞体。
碰撞体 用于接收结果的 Collider2D 列表。

返回值

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

描述

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

整数返回值是写入 results 列表的结果数量。如果 results 列表不包含足够元素来报告所有结果，则该列表将被调整大小。这可以防止在不需要调整 results 列表大小时分配结果的内存，并在频繁执行查询时提高垃圾回收性能。

其他资源：Collider2D.GetContacts 和 Rigidbody2D.GetContacts。

声明

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

参数

rigidbody 要检索碰撞体的刚体。将检查附加到此刚体的所有碰撞体。
contactFilter 用于以不同方式过滤结果的接触过滤器，例如按图层蒙版、Z 深度或法线角度。
碰撞体 用于接收结果的 Collider2D 列表。

返回值

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

描述

检索与附加到此刚体的任何碰撞体接触的所有碰撞体，结果由 contactFilter2D 过滤。

整数返回值是写入 results 列表的结果数量。如果 results 列表不包含足够元素来报告所有结果，则该列表将被调整大小。这可以防止在不需要调整 results 列表大小时分配结果的内存，并在频繁执行查询时提高垃圾回收性能。

结果也可以由 contactFilter 过滤。

其他资源：Collider2D.GetContacts 和 Rigidbody2D.GetContacts。

声明

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

参数

rigidbody 要检索碰撞体的刚体。将检查附加到此刚体的所有碰撞体。
contacts 用于接收结果的 ContactPoint2D 列表。

返回值

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

描述

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

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

整数返回值是写入 results 列表的结果数量。如果 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 列表不包含足够元素来报告所有结果，则该列表将被调整大小。这可以防止在不需要调整 results 列表大小时分配结果的内存，并在频繁执行查询时提高垃圾回收性能。

结果也可以由 contactFilter 过滤。

其他资源：Collider2D.GetContacts 和 Rigidbody2D.GetContacts。

此处描述的内容是否没有按预期工作？它可能是已知问题。请在以下问题跟踪器中查看 issuetracker.unity3d.com.

版权所有 ©2005-2024 Unity Technologies。保留所有权利。构建自：6000.0.25f1 (91cbff7fd174)。构建于：2024-10-19。
教程 社区问答 知识库 论坛 资源商店 使用条款 法律 隐私政策 Cookie 不销售或共享我的个人信息