游戏引擎 / 系统课时
用 Raycast 做交互检测
用 Raycast 做交互检测
玩家按下交互键却拾取不到准星中的物体,或脚下明明有地面却被判为空中,通常需要检查射线的起点、方向、过滤范围和命中处理。本课实现可运行的准星拾取,并用另一条向下射线确认接地状态。
学习目标
- 理解
Physics.Raycast的射线参数与RaycastHit命中信息。 - 实现对准物体按 E 拾取的交互,并正确处理遮挡。
- 用向下射线探测地面,排查漏检与误检。
射线检测返回什么
Physics.Raycast 从世界坐标中的起点沿指定方向检测碰撞体;命中时返回 true,并可通过 RaycastHit 取得 collider、point、normal 和 distance。它是空间查询,不会自动推动刚体或触发拾取逻辑,后续动作必须由脚本决定。
准星交互从摄像机视口中心 (0.5, 0.5) 发射射线;接地检测则从角色脚部上方朝 Vector3.down 发射短射线。两条射线的起点和筛选层不同,不能混用检测范围。

搭建可验证的场景
- 在场景放置
Plane作为地面,保留 Collider,并新建GroundLayer 后赋给地面。 - 创建带
BoxCollider的立方体,命名PickupBox;新建InteractableTag 并赋给它。让立方体位于摄像机正前方 3 米内。 - 在玩家脚部附近添加空子物体
FootProbe,将其放在地面上方约 0.2 米;确认玩家有主摄像机可引用。 - 新建
RaycastInteractor.cs并挂到玩家对象上,将View Camera、Foot Probe赋值,Ground Mask只选Ground;Look Mask应包含目标和可能遮挡它的墙体层,排除玩家自身的层。
示例采用经典 Input.GetKeyDown;如果项目只启用了新 Input System,需要改用对应输入动作,或在 Player Settings 中启用兼容的旧输入处理方式。
编写拾取与接地脚本
csharp
using UnityEngine;
public sealed class RaycastInteractor : MonoBehaviour
{
[SerializeField] private Camera viewCamera;
[SerializeField] private Transform footProbe;
[SerializeField] private LayerMask lookMask = ~0;
[SerializeField] private LayerMask groundMask;
[SerializeField] private float reach = 3f;
[SerializeField] private float groundRange = 0.35f;
private bool wasGrounded;
private void Update()
{
if (viewCamera == null) return;
// 视口中心不依赖屏幕分辨率,射线首先命中最近的有效碰撞体。
Ray ray = viewCamera.ViewportPointToRay(new Vector3(0.5f, 0.5f, 0f));
bool hasHit = Physics.Raycast(
ray, out RaycastHit hit, reach, lookMask,
QueryTriggerInteraction.Ignore);
Debug.DrawRay(ray.origin,
ray.direction * (hasHit ? hit.distance : reach),
hasHit ? Color.green : Color.red);
if (!hasHit || !Input.GetKeyDown(KeyCode.E)) return;
if (!hit.collider.CompareTag("Interactable")) return;
GameObject target = hit.collider.gameObject;
Debug.Log("拾取成功:" + target.name);
target.SetActive(false);
}
private void FixedUpdate()
{
if (footProbe == null) return;
// 地面只在 Ground Layer 查询,避免命中角色自身。
bool grounded = Physics.Raycast(
footProbe.position, Vector3.down, groundRange,
groundMask, QueryTriggerInteraction.Ignore);
Debug.DrawRay(footProbe.position, Vector3.down * groundRange,
grounded ? Color.green : Color.yellow);
if (grounded != wasGrounded)
Debug.Log("接地状态:" + grounded);
wasGrounded = grounded;
}
}预期输出:玩家站在地面上,准星对准 PickupBox 并按 E 后,Console 依次可见:
text
接地状态:True
拾取成功:PickupBoxPickupBox 随即消失;在 Scene 视图开启 Gizmos 后能看到射线颜色。接地日志只在状态发生变化时打印,不会每个物理步刷屏。
遇到不命中时怎么排查
- 射线看得见却拾取不了:检查最近命中物是否为墙体;不要只勾选交互物层而排除遮挡墙,否则可能隔墙拾取。
- 目标始终漏检:确认物体有启用的 Collider、距离不超过
reach、Look Mask包含其 Layer;本例忽略Is Trigger碰撞体。 - 脚下地面漏检:核对
FootProbe是否高于地面且在groundRange范围内,并检查Ground Mask。 - 射线从物体内部发出:3D Raycast 通常不会报告包住射线起点的碰撞体,应移出起点或调整探针位置。
可以在摄像机与 PickupBox 之间放置有 Collider 的墙体,再按 E 验证无法穿墙拾取。交互查询放在 Update 响应按键,依赖物理状态的接地探针则在 FixedUpdate 中采样,两种用途各自保持清晰。
按自己的节奏,确认真正理解。