Debug.DrawRay

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

public static void **DrawRay** ([Vector3](https://docs.unity3d.com/cn/2019.4/ScriptReference/Vector3.html) **start**, [Vector3](https://docs.unity3d.com/cn/2019.4/ScriptReference/Vector3.html) **dir**, [Color](https://docs.unity3d.com/cn/2019.4/ScriptReference/Color.html) **color**= Color.white, float **duration**= 0.0f, bool **depthTest**= true);

## 参数

| start     | 应作为该射线起始点的世界空间中的点。       |
| ----------- | -------------------------------------------- |
| dir       | 该射线的方向和长度。                       |
| color     | 绘制的直线的颜色。                         |
| duration  | 该直线的可见时长（单位为秒）。             |
| depthTest | 该直线是否应被靠近此摄像机的其他对象遮挡？ |

## 描述

在世界坐标中绘制一条从 `start` 到 `start` + `dir` 的直线。

`duration` 参数确定在绘制该直线所在的帧之后该直线可见时长。如果持续时间为 0（默认值），则该直线被渲染 1 帧。

如果将 `depthTest` 设置为 true，则该直线将被此场景中更靠近摄像机的其他对象遮挡。

将在该 Editor 的场景视图中绘制该直线。如果在游戏视图中启用了辅助图标绘图，则在该视图中也将绘制该直线。

```
using UnityEngine;

public class Example : MonoBehaviour
{
    // Frame update example: Draws a 10 meter long green line from the position for 1 frame.
    void Update()
    {
        Vector3 forward = transform.TransformDirection(Vector3.forward) * 10;
        Debug.DrawRay(transform.position, forward, Color.green);
    }
}
```

```
using UnityEngine;

public class Example : MonoBehaviour
{
    // Event callback example: Debug-draw all contact points and normals for 2 seconds.
    void OnCollisionEnter(Collision collision)
    {
        Debug.DrawRay(collision.contacts[0].point, collision.contacts[0].normal, Color.green, 2, false);
    }
}
```