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

Physics2D.CircleCast

建议更改

成功!

感谢您帮助我们提高 Unity 文档的质量。虽然我们无法接受所有提交内容,但我们会阅读用户提出的每个建议更改,并在必要时进行更新。

关闭

提交失败

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

关闭

取消

声明

public static RaycastHit2D CircleCast(Vector2 origin, float radius, Vector2 direction, float distance = Mathf.Infinity, int layerMask = DefaultRaycastLayers, float minDepth = -Mathf.Infinity, float maxDepth = Mathf.Infinity);

参数

origin 圆形在 2D 空间中的起始点。
radius 圆形的半径。
direction 表示圆形方向的向量。
distance 投射圆形的最大距离。
layerMask 筛选器,仅检测某些层上的碰撞器。
minDepth 仅包含 Z 坐标(深度)大于或等于此值的物体。
maxDepth 仅包含 Z 坐标(深度)小于或等于此值的物体。

返回值

RaycastHit2D 返回的投射结果。

描述

将圆形投射到场景中的碰撞器上,返回第一个与其接触的碰撞器。

CircleCast 在概念上类似于在场景中以特定方向拖动一个圆形。可以检测到并报告与圆形发生接触的任何物体。

此函数返回一个 RaycastHit2D 对象,该对象包含对被盒子击中的碰撞器的引用(如果未击中任何物体,则结果的 Collider 属性将为 NULL)。layerMask 可用于有选择地仅检测某些层上的物体(例如,这允许您仅对敌方角色应用检测)。

返回的 RaycastHit2D 返回圆形与碰撞器接触的点的坐标和法线。它还返回圆形要放置在该点以使其发生接触的质心。

其他资源:LayerMask 类,RaycastHit2D 类,:CircleCastAllCircleCastNonAllocDefaultRaycastLayersIgnoreRaycastLayerraycastsHitTriggers


声明

public static int CircleCast(Vector2 origin, float radius, Vector2 direction, ContactFilter2D contactFilter, RaycastHit2D[] results, float distance = Mathf.Infinity);

参数

origin 圆形在 2D 空间中的起始点。
radius 圆形的半径。
direction 表示圆形方向的向量。
contactFilter 用于以不同方式筛选结果的接触过滤器,例如通过层掩码、Z 深度或法线角度。
results 接收结果的数组。数组的大小决定了可以返回的最大结果数。
distance 投射圆形的最大距离。

返回值

int 返回写入 results 数组中的结果数量。

描述

将圆形投射到场景中的碰撞器上,返回所有与其发生接触的碰撞器。

此函数返回找到的接触数,并将这些接触放置在 results 数组中。结果也可以通过 contactFilter 筛选。

其他资源:ContactFilter2DRaycastHit2D


声明

public static int CircleCast(Vector2 origin, float radius, Vector2 direction, ContactFilter2D contactFilter, List<RaycastHit2D> results, float distance = Mathf.Infinity);

参数

origin 圆形在 2D 空间中的起始点。
radius 圆形的半径。
direction 表示圆形方向的向量。
contactFilter 用于以不同方式筛选结果的接触过滤器,例如通过层掩码、Z 深度或法线角度。
results 接收结果的列表。
distance 投射圆形的最大距离。

返回值

int 返回写入 results 列表中的结果数量。

描述

将圆形投射到场景中的碰撞器上,返回所有与其发生接触的碰撞器。

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

结果也可以通过 contactFilter 筛选。

其他资源:ContactFilter2DRaycastHit2D