游戏引擎 / 系统课时

减少 UI 无效射线检测

减少 UI 无效射线检测

在 Unity 6 的 uGUI 中,纯展示用的图片和文字如果仍勾选 Raycast Target,就可能被纳入指针命中检测。本篇以一个按钮面板为例,精简检测候选、保留必要的点击区域,并用 Profiler 验证 CPU 开销是否下降。

学习目标

  • 识别哪些 Image 和 TextMeshPro 图形不需要参与 UI 射线检测。
  • 用 Inspector 或 C# 关闭指定图形的 raycastTarget,不破坏按钮交互。
  • 在相同输入负载下对比优化前后的射线检测耗时。

找出多余的检测候选

本篇适用于 Canvas + GraphicRaycaster + EventSystem 的 uGUI(Unity 6 / 6000.x),不适用于 UI Toolkit 的元素拾取设置。GraphicRaycaster 根据指针位置检查本 Canvas 上允许接收射线检测的 Graphic;Raycast Target 开启不代表图形具有点击回调,但它仍可能参与命中测试。被上层装饰图片命中时,下层按钮也可能收不到点击。

图形 建议 原因
血条装饰、背景花纹、纯展示图标 关闭 无需接收指针事件
普通说明文字、按钮上的 TMP 文字 关闭 按钮的底图通常已提供命中区域
Button 所用的 Image 底图 保留 需要提供可命中的交互区域
全屏遮罩或用于拦截点击的透明 Image 保留 虽然不显眼,但承担事件拦截职责

例如,一个 Canvas 只有 1 个按钮底图和 5 个展示图形,初始都勾选 Raycast Target,则有 6 个活动检测候选;关闭 5 个展示图形后只留下按钮底图。候选减少不等于射线检测耗时一定按比例减少。

关闭目标并保持点击区域

  1. 在 Hierarchy 中选中纯展示的 Image 或 TextMeshPro - Text (UI) 对象。
  2. 在 Inspector 的相应图形组件中取消勾选 Raycast Target;按钮文字可以关闭,按钮用于命中的 Image 通常不能关闭。
  3. 选中 Canvas 检查 Graphic Raycaster:完全不接收指针交互的独立 Canvas 可以移除该组件;含有 Button、ScrollRect 等交互区域的 Canvas 则必须保留。
  4. 进入 Play 模式,逐项测试按钮点击、滚动拖拽和弹窗遮罩是否还能正常工作。

装饰图形关闭射线检测前后的命中差异

Raycast Target 只控制是否参与图形射线检测,不会直接减少绘制批次或解决 Canvas 重建。不要把需要拦截点击的透明层误判为“无效图片”。

只批量处理明确指定的装饰图形

如果预制体里有很多装饰项,可以把以下脚本保存为 UIRaycastTargetCleaner.cs,挂到对应 Canvas,并在 Inspector 的 Decorative Graphics 数组中拖入确认不需要交互的图形。脚本只在运行时关闭这些目标,不会永久修改预制体。

csharp
using UnityEngine;
using UnityEngine.UI;

[RequireComponent(typeof(Canvas))]
public sealed class UIRaycastTargetCleaner : MonoBehaviour
{
    [SerializeField] private Graphic[] decorativeGraphics;

    private void Start()
    {
        int before = CountActiveTargets();
        int changed = 0;

        // 只修改人工确认的装饰图形,避免误伤按钮底图。
        if (decorativeGraphics != null)
        {
            foreach (Graphic graphic in decorativeGraphics)
            {
                if (graphic == null || !graphic.raycastTarget) continue;
                graphic.raycastTarget = false;
                changed++;
            }
        }

        Debug.Log($"UI RaycastTarget: {before} -> {CountActiveTargets()}, changed={changed}");
    }

    private int CountActiveTargets()
    {
        int count = 0;
        Canvas owner = GetComponent<Canvas>();

        // 只统计当前 Canvas 内已启用的 Graphic。
        foreach (Graphic graphic in GetComponentsInChildren<Graphic>(true))
        {
            if (graphic.isActiveAndEnabled &&
                graphic.canvas == owner && graphic.raycastTarget)
                count++;
        }
        return count;
    }
}

预期输出(Canvas 内恰有 1 个可点击 Image 和 5 个已开启检测的装饰图形,且数组恰好指定这 5 个对象):

text
UI RaycastTarget: 6 -> 1, changed=5

其他场景的数字取决于活动图形数量。此日志统计的是当前 Canvas 中启用 Raycast Target 的活动图形,不是一次实际射线命中的数量;对于正式资源,检查无误后可在 Inspector 中保存相同的开关设置,而不是依赖运行时清理。

用 Profiler 验证并排除误判

  1. 通过 Window > Analysis > Profiler 打开 Profiler,连接目标设备上的 Development Build。保持分辨率、场景、输入模块和设备一致。
  2. 在未清理的版本中,持续执行同一套指针移动与点击操作,采集约 300 帧;进入 CPU Usage > Hierarchy 或 Timeline,查看 EventSystem.Update 下的输入处理及可见的 GraphicRaycaster.Raycast 样本。
  3. 清理后重复采集,比较相同操作区间的耗时中位数与高耗时帧。示例演算:若射线检测耗时从 0.40 ms 降到 0.16 ms,节省 0.24 ms;这是计算示例,不是保证收益。
  4. 验收点击、拖拽、滚动、弹窗遮罩与多点触控;若功能异常,优先检查是否关掉了实际承接事件的 Image,或错误移除了交互 Canvas 上的 Graphic Raycaster。

当瓶颈主要来自 Canvas.BuildBatch、布局刷新或 GPU Overdraw 时,关闭 Raycast Target 不会直接解决这些问题。优先处理可确认的无效候选,再依据实际 Profiler 数据决定是否继续拆分交互与非交互 Canvas。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

减少 UI 无效射线检测

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通