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
相关产品推荐
相关产品推荐

