Physics.Raycast

Physics.Raycast

介绍

Physics.Raycast 是 Unity 中用于检测物体之间碰撞的函数之一。它使用一条射线来检测场景中的物体，返回一个 bool 值表示是否检测到了碰撞，以及一个 RaycastHit 结构体存储着射线碰撞到的物体的信息。

方法

Physics.Raycast 的完整签名如下：

bool Physics.Raycast(Ray ray, out RaycastHit hitInfo, float maxDistance = Mathf.Infinity, int layerMask = DefaultRaycastLayers, QueryTriggerInteraction queryTriggerInteraction = QueryTriggerInteraction.UseGlobal);
1

该函数的参数如下：

• ray：一条用于检测碰撞的射线。
• hitInfo：一个 RaycastHit 结构体，存储着射线碰撞到的物体的信息。
• maxDistance：射线的最大长度，表示在这个距离内检测碰撞。
• layerMask：一个用于指定哪些物体应该被检测的层蒙版。可以使用 LayerMask.NameToLayer() 函数将层的名称转换为相应的层蒙版。
• queryTriggerInteraction：一个用于指定是否应该检测触发器的枚举类型。默认情况下，它使用 QueryTriggerInteraction.UseGlobal，该值使用全局的触发器检测设置。

举例子

示例 1：使用射线检测物体

下面的示例代码演示了如何使用 Physics.Raycast 函数进行射线检测：

Ray ray = new Ray(transform.position, transform.forward);
RaycastHit hit;
if (Physics.Raycast(ray, out hit))
{
    Debug.Log("Hit object: " + hit.collider.gameObject.name);
}
1
2
3
4
5
6

在这个示例中，我们创建了一条射线，起点为当前物体的位置，方向为当前物体的正前方。然后，我们使用 Physics.Raycast 函数进行射线检测，检测是否有物体与射线相交。如果有相交，hit 变量中将包含碰撞物体的信息，我们在控制台上输出该物体的名称。

示例 2：指定检测范围

下面的示例代码演示了如何指定射线的最大长度，以限制射线检测的范围：

Ray ray = new Ray(transform.position, transform.forward);
RaycastHit hit;
if (Physics.Raycast(ray, out hit, 10.0f))
{
    Debug.Log("Hit object: " + hit.collider.gameObject.name);
}
1
2
3
4
5
6

在这个示例中，我们创建了一条射线，起点为当前物体的位置，方向为当前物体的正前方。然后，我们使用 Physics.Raycast 函数进行射线检测，并指定最大长度为 10。这意味着射线只会在距离当前物体不超过 10 的范围内进行检测。如果有相交，hit 变量中将包含碰撞物体的信息，我们在控制台上输出该物体的名称。

示例 3：指定检测层次

下面的示例代码演示了如何指定只检测特定层次的物体：

Ray ray = new Ray(transform.position, transform.forward);
RaycastHit hit;
int layerMask = LayerMask.GetMask("MyLayer");
if (Physics.Raycast(ray, out hit, Mathf.Infinity, layerMask))
{
    Debug.Log("Hit object: " + hit.collider.gameObject.name);
}
1
2
3
4
5
6
7

在这个示例中，我们创建了一条射线，起点为当前物体的位置，方向为当前物体的正前方。然后，我们使用 LayerMask.GetMask 函数获取名为 "MyLayer" 的层次的层蒙版，表示只检测该层次的物体。最后，我们使用 Physics.Raycast 函数进行射线检测，并指定层蒙版。如果有相交，hit 变量中将包含碰撞物体的信息，我们在控制台上输出该物体的名称。注意，在这个示例中，我们还指定了最大长度为 Mathf.Infinity，表示不限制射线的最大长度。