unity 中射线检测案例，给出脚本

### Unity 中 `Physics.Raycast` 方法详解 #### 基础概念 `Physics.Raycast` 是 Unity 提供的一种物理射线检测工具，允许开发者从指定起点沿特定方向发射一条虚拟射线，并判断该射线是否与场景中的碰撞体（Collider）相交[^2]。 --- #### 函数签名 以下是 `Physics.Raycast` 的函数定义及其参数说明： ```csharp public static bool Raycast( Vector3 origin, // 射线的起始位置 Vector3 direction, // 射线的方向向量（单位化） out RaycastHit hitInfo, // 存储射线命中的信息 float maxDistance = Mathf.Infinity, // 射线的最大长度，默认无限远 int layerMask = DefaultRaycastLayers, // 层级掩码，控制哪些层上的对象会被检测到 QueryTriggerInteraction queryTriggerInteraction = QueryTriggerInteraction.UseGlobal // 是否考虑触发器交互 ); ``` - **origin**: 表示射线的起点坐标。 - **direction**: 定义射线的方向。通常需要对该向量进行标准化处理 (`normalized`) 来确保其为单位向量。 - **hitInfo**: 输出变量，存储射线击中目标的相关数据，例如距离、法线方向以及被击中的碰撞体等。 - **maxDistance**: 可选参数，表示射线的有效范围。如果未设置，则默认延伸至无穷远处。 - **layerMask**: 控制射线仅作用于某些图层的对象上。通过位运算组合多个图层来实现更精确的选择。 - **queryTriggerInteraction**: 决定射线是否会与标记为 Trigger 的 Collider 发生反应。 --- #### 示例代码 下面是一个完整的 C# 实现案例，展示如何利用鼠标点击事件执行射线投射并获取命中结果。 ```csharp using UnityEngine; public class RaycastExample : MonoBehaviour { void Update() { if (Input.GetMouseButtonDown(0)) // 当左键按下时触发 { Ray ray = Camera.main.ScreenPointToRay(Input.mousePosition); // 获取屏幕空间下的射线 RaycastHit hit; if (Physics.Raycast(ray, out hit, 100f)) { Debug.Log($"Hit object name: {hit.collider.name}"); // 打印被击中物体的名字 // 绘制调试线条显示射线路径 Debug.DrawRay(ray.origin, ray.direction * hit.distance, Color.red); // 如果你想进一步操作这个物体... Transform targetObject = hit.transform; // 添加更多逻辑，比如改变颜色或者播放音效 } } } } ``` 上述脚本实现了以下功能： 1. 检测玩家是否单击了鼠标左键。 2. 创建了一条基于当前摄像机视角和鼠标的三维世界射线。 3. 判断这条射线是否碰到任何具有刚体或碰撞组件的游戏物件。 4. 若存在接触点，则记录下具体的信息并通过日志输出。 --- #### 注意事项 - 确保参与测试的目标物体内置有效的 Collider 部件；否则即使几何形状重叠也不会返回 true 结果[^3]。 - 对于性能敏感的应用场合，请合理设定最大探测距离(maxDistance)，从而减少不必要的计算开销。 - Layer Mask 参数可以帮助过滤掉不需要关注的类别实体，在复杂项目里特别有用。 ---