游戏引擎 / 系统课时

用 UI Profiler 查重建频率

用 UI Profiler 查重建频率

一个每帧刷新的分数文本,可能让整块 HUD 反复参与 UI 更新。本篇以 Unity 6 的 uGUI(Canvas)为例,采集同一交互下的布局、批处理和 CPU 耗时,再通过对照实验定位不断触发更新的区域。

学习目标

  • 在 Profiler 中找到 uGUI 的 Layout、Render、Batches 和事件标记。
  • 区分“批次数较多”与“频繁重建”,用同一时间窗口对比更新频率。
  • 通过停用动态更新脚本和拆分 Canvas 验证问题来源。

采集同一场景的 UI 帧

  1. 在 Unity 6 中运行含血量条、分数文本或滚动列表的场景,打开 Window > Analysis > Profiler,采集目标为 Play Mode。
  2. 在模块添加菜单中启用 UI (Canvas)、UI Details (Canvas) 和 CPU Usage。部分 Unity 6.0 界面或 uGUI 包版本显示为 UI、UI Details。
  3. 先让界面静止约 2 秒,再连续修改分数或滚动列表约 2 秒;暂停录制后选择出现尖峰的帧。
  4. 在 UI (Canvas) 看 Layout、Render 时间;在 UI Details (Canvas) 看 Batches、Vertices,打开 Markers 将点击、滑动等交互事件与峰值对齐。

Unity 6 uGUI Profiler 模块与帧定位路径

判断是重建过频还是绘制过多

UI Details (Canvas) 的 Self Batch Count 是当前 Canvas 的批次数,Cumulative Batch Count 包含其子 Canvas;它们不是每秒重建次数。Batch Breaking Reason 能解释材质、贴图或裁剪等造成的断批,却不能直接证明谁反复把布局标脏。

在 CPU Usage > Timeline 中查看同一尖峰帧的 Canvas.SendWillRenderCanvases 与 Canvas.BuildBatch(采样名随版本和调用路径可能变化)。前者对应 Canvas 渲染前的 UI 更新回调,后者反映 Canvas 批处理构建工作;结合 Layout 耗时,才能区分排版、图形更新与合批开销。Markers 记录交互事件,也不是重建计数器。

可先选取连续 120 帧,记录有明显 UI 更新采样的帧数。例如静止阶段为 4/120,滚动阶段为 108/120,表示后者的 UI 更新更持续;这只是有更新开销的帧占比,不等于内部精确重建调用次数。不要以批次数单独推断重建频率。

用脚本复现持续刷新

创建带 Canvas 的场景,通过 GameObject > UI (Canvas) > Legacy > Text 添加 Text (Legacy)(uGUI Text,不是 UI Toolkit 文本),新建 UIRebuildProbe.cs 并挂到任意活动对象,将 Label 指向该文字。勾选 Update Every Frame 时每帧修改显示内容;取消后约每 0.5 秒修改一次。此代码不要求额外插件。

csharp
using UnityEngine;
using UnityEngine.UI;

public sealed class UIRebuildProbe : MonoBehaviour
{
    [SerializeField] private Text label;
    [SerializeField] private bool updateEveryFrame = true;

    private float nextWriteTime;
    private float nextReportTime;
    private int changes;
    private int value;

    private void Start()
    {
        // 明确暴露场景连线错误,避免把空引用当成性能问题。
        if (label == null)
        {
            Debug.LogError("Assign Label in Inspector.");
            enabled = false;
            return;
        }

        nextReportTime = Time.unscaledTime + 1f;
    }

    private void Update()
    {
        if (updateEveryFrame || Time.unscaledTime >= nextWriteTime)
        {
            // 内容发生真实变化才更新文本,制造可观察的脏标记。
            label.text = (++value).ToString();
            changes++;
            nextWriteTime = Time.unscaledTime + 0.5f;
        }

        if (Time.unscaledTime >= nextReportTime)
        {
            Debug.Log($"UI text changes/sec: {changes}");
            changes = 0;
            nextReportTime = Time.unscaledTime + 1f;
        }
    }
}

预期输出(Console,每秒一行;<COUNT> 随帧率和模式变化):

text
UI text changes/sec: <COUNT>

在接近 60 FPS 的稳定条件下,两种模式通常分别约为每秒 60 次、2 次文本变更。日志统计的是脚本写入次数,不是 Unity 内部重建次数;在 Profiler 中比较 Layout、Canvas.BuildBatch 等采样才是本实验的重点。

锁定高频更新的 Canvas

  1. 选中问题帧,在 UI Details (Canvas) 的 Object 列找到可疑 Canvas,查看 Self Batch Count、Cumulative Batch Count 和 Batch Breaking Reason;双击对象可在场景中定位。
  2. 保持场景和操作一致,先禁用某个分数刷新脚本或列表内容更新脚本,再观察连续帧中的 UI 更新采样和 CPU 耗时是否下降。逐个恢复脚本,比同时关闭整组 UI 更容易锁定触发源。
  3. 若只有小型数值区每帧变化,却与大量静态图标共用一个 Canvas,可把数值区移至独立子 Canvas,再复测 Canvas.BuildBatch;子 Canvas 能隔离批处理重算范围,但可能增加批次与绘制调用。
  4. 若 Layout 耗时高,检查变化对象及其父级是否使用 HorizontalLayoutGroup、VerticalLayoutGroup、ContentSizeFitter,以及是否有脚本持续改变 RectTransform 尺寸;优先消除无意义的逐帧改动。

复测并确认改善

使用同一分辨率、同一操作路径与相近帧数,分别保存“修改前”和“修改后”的 Profiler 采样。至少对照 120 帧内出现 UI 热点的帧数、UI Layout/Render 耗时分布、Canvas.BuildBatch 时间和 Batches 数量。比如热点帧由 108/120 降到 5/120,同时 CPU 峰值降低且绘制批次未异常上涨,才可认定修改有效;这些数字是验收算例,并非 Unity 的固定阈值。

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

目录与阅读设置

阅读设置

17

记录一个想法

用 UI Profiler 查重建频率

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

登录哪都通