You need to enable JavaScript to run this app. Unity 中如何正确检测玩家与指定游戏对象的触碰并触发对应逻辑?
优惠活动
大模型
产品
解决方案
定价
更多

Unity 中如何正确检测玩家与指定游戏对象的触碰并触发对应逻辑?

Unity 跑酷项目碰撞检测问题定位与可运行实现

原有代码的报错核心原因

  • 逻辑错配:OnCollisionEnter 是挂脚本的物体自身发生碰撞时自动触发的回调,参数Collision本身已经携带了碰撞对方的完整信息,不需要手动调用工具方法反复查询两个预设物体的接触状态
  • 方法时序错误:CollisionDetection.IsTouching 是用于逐帧主动检测接触状态的工具,写在一次性触发的碰撞回调里会出现时序错位,大概率出现空引用报错、返回值和实际碰撞状态不匹配的问题
  • 组件配置错配:动量类跑酷项目的移动逻辑多依赖Rigidbody或CharacterController,很多开发者会混淆物理碰撞、触发检测的适用场景,硬走带冲量的物理碰撞逻辑,既会干扰跑酷的动量手感,也容易出现碰撞回调根本不触发的问题

前置组件配置

完成下面的配置才能保证检测逻辑正常触发:

  • 给玩家挂载 Rigidbody 组件,根据你的动量玩法调整重力、线性阻尼、角阻尼参数,不要勾选Is Kinematic
  • 玩家、终点交互Cube、地图下方的掉出检测区域,全部挂载Collider组件,勾选Collider面板上的Is Trigger选项——两类交互逻辑不需要物理弹开反馈,用触发检测的性能开销更低,也不会打断玩家的移动惯性

带详细注释的可运行完整代码

这个脚本直接挂载在玩家对象上即可,不需要额外写多余的碰撞判断:

using UnityEngine;
using UnityEngine.SceneManagement;
using System.Collections;

// 玩家碰撞逻辑脚本,直接挂玩家身上
public class PlayerCollisionLogic : MonoBehaviour
{
    [Header("对象引用配置")]
    [Tooltip("把场景里的终点交互Cube拖到这里")]
    public GameObject endPointCube;
    [Tooltip("把地图下方的掉出检测空区域拖到这里")]
    public GameObject fallDetectZone;

    [Header("逻辑参数配置")]
    [Tooltip("死亡后重载关卡的延迟时间(给死亡动画留播放窗口)")]
    public float reloadDelay = 1f;
    [Tooltip("主菜单的场景名称,和Build Settings里的名字保持一致")]
    public string mainMenuSceneName = "MainMenu";

    // 触发检测回调:只要任意勾了Is Trigger的Collider和玩家重叠,就会自动触发
    private void OnTriggerEnter(Collider other)
    {
        // 逻辑1:碰到终点对象
        if (other.gameObject == endPointCube)
        {
            // 延迟切场景,给通关的粒子、音效留播放时间,避免跳太突兀
            StartCoroutine(LoadMainMenuAfterDelay());
            return;
        }

        // 逻辑2:掉出地图碰到检测区
        if (other.gameObject == fallDetectZone)
        {
            TriggerDeathLogic();
        }
    }

    // 自定义死亡逻辑
    private void TriggerDeathLogic()
    {
        // 先禁用玩家的移动脚本,防止死亡状态下还在靠惯性滑动
        GetComponent<PlayerMovement>().enabled = false;
        // 延迟重载当前关卡
        StartCoroutine(ReloadCurrentSceneAfterDelay());
    }

    // 延迟重载关卡的协程
    private IEnumerator ReloadCurrentSceneAfterDelay()
    {
        yield return new WaitForSeconds(reloadDelay);
        // 直接加载当前激活的场景,不需要手动填场景名
        SceneManager.LoadScene(SceneManager.GetActiveScene().buildIndex);
    }

    // 延迟加载主菜单的协程
    private IEnumerator LoadMainMenuAfterDelay()
    {
        yield return new WaitForSeconds(0.5f);
        SceneManager.LoadScene(mainMenuSceneName);
    }
}

常见踩坑提示

  • 如果你坚持要用带物理冲量的OnCollisionEnter而不是触发检测,记得交互对象的Collider不要勾Is Trigger,且交互对象至少有一方挂载非Kinematic的Rigidbody,否则Unity根本不会触发碰撞回调
  • 掉出地图的检测Box Collider要放在地图地面下方10-20米的位置,整体范围要比整张地图大一圈,确保玩家不管从哪个方向坠落都能碰到,不会出现卡空无触发的情况
  • 不要把CollisionDetection.IsTouching写在碰撞回调里,这个方法适合放在FixedUpdate里持续做接触状态校验,放在一次性回调里的性价比极低,还容易出逻辑bug

内容的提问来源于stack exchange,提问作者Valu

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.06 00:54:06