游戏引擎 / 系统课时
Frame Debugger 逐步查绘制
Frame Debugger 逐步查绘制
同一个物体在画面里只出现一次,却可能因阴影、深度预写入、额外相机或多个 Shader Pass 被绘制多次。使用 Frame Debugger 逐步回放一帧,核对事件所属阶段、渲染对象与目标缓冲区,就能判断哪些绘制是必要的,哪些值得删减。
学习目标
- 在 Unity 6 中逐项查看绘制事件和画面变化。
- 识别多余的相机绘制、材质切换与重复 Pass。
- 用相同场景的性能采样验证优化收益。
搭建材质切换对照场景
以下示例适用于 Unity 6(6000.x)的 URP 项目。新建场景并保留一台 Main Camera。在 Project 中创建两个 Material:A 使用 Universal Render Pipeline/Lit,B 使用 Universal Render Pipeline/Unlit。建立空对象 FrameProbe,挂载脚本 FrameDrawProbe.cs,在 Inspector 中把两个材质分别拖入对应字段。
using UnityEngine;
public sealed class FrameDrawProbe : MonoBehaviour
{
[SerializeField] private Material materialA;
[SerializeField] private Material materialB;
private void Start()
{
if (materialA == null || materialB == null)
{
Debug.LogError("请先指定 materialA 和 materialB");
return;
}
// 第三个物体切换到另一种 Shader,形成事件对照。
// 使用 sharedMaterial,避免测试时无意创建材质副本。
for (int i = 0; i < 3; i++)
{
GameObject cube = GameObject.CreatePrimitive(PrimitiveType.Cube);
cube.name = $"FrameProbe_{i}";
cube.transform.position = new Vector3((i - 1) * 2f, 0f, 0f);
cube.GetComponent<MeshRenderer>().sharedMaterial =
i == 2 ? materialB : materialA;
}
Debug.Log("FrameProbe: A=2, B=1");
}
}预期输出(进入 Play Mode 后查看 Console):
FrameProbe: A=2, B=1将 Main Camera 调整到可同时看见三个立方体:左侧两个共用材质 A,右侧一个使用材质 B。脚本生成三个 Renderer,不意味着整帧恰好只有三次绘制;阴影与深度阶段可能分别绘制同一网格。临时关闭无关的 UI 和额外相机,减少干扰。
启用 Frame Debugger 并逐步回放
- 在 Play Mode 中固定视角,打开
Window > Analysis > Frame Debugger。 - 在窗口顶部将 Target 选为
Editor,点击Enable。 - 在左侧
Event Hierarchy展开当前相机的绘制阶段,选中一个Draw Mesh类型事件。 - 使用
Previous event、Next event或事件滑块逐项回放,同时观察 Game 视图中新增了什么。 - 查看
Event Information中的网格、Shader、Pass 和渲染目标,记录可疑事件的位置。

在启用 Render Graph 的 URP 项目中,事件树可能包含 ExecuteRenderGraph 和渲染通道编号;无需寻找某个固定序号,应从相机、渲染目标和事件内容定位。界面操作可对照 Unity 6 官方说明。
排查重复绘制与材质切换
看到同一 Renderer 多次出现,先确认它属于哪个阶段,不要直接删除 Pass。
| 观察现象 | 核对方法 | 处理方式 |
|---|---|---|
| 同一网格先进入阴影图,再进入主颜色目标 | 比较 Render Target、ShadowCaster 与正向绘制 Pass |
通常属正常流程;不需要投影的对象可关闭 Mesh Renderer > Cast Shadows |
| 同一物体在两个相机的颜色目标中分别绘制 | 检查 Camera Stack、相机 Culling Mask 与画面覆盖区域 |
删除无必要的叠加相机或缩小其剔除范围 |
| 不透明物体绘制之间频繁切换 Shader | 对照相邻事件的 Shader、关键字及 SRP Batch 断批原因 | 减少不必要的 Shader 变体,尽可能复用兼容材质 |
| 同一效果出现多个额外全屏处理阶段 | 检查 URP Renderer Feature、后处理配置及目标纹理变化 | 暂时禁用一个效果后重新采样,确认视觉无损再移除 |
URP 的 SRP Batcher 可以连续处理使用不同材质、但 Shader 变体兼容的对象;材质不同不等于必然断批。若事件列表提供 SRP Batch 详情,重点看批次无法合并的原因。一个物体的 ShadowCaster 与主颜色 Pass 同时存在也不是“画了两遍”的直接证据。
修改后用真机指标验收
按“发现事件→确认所属阶段→只修改一个原因→重新捕获”的顺序操作。例如,先禁用一个无必要的 Overlay Camera,检查其对应的相机绘制分组是否消失,再观察游戏画面是否仍完整。不要一次关掉阴影、后处理和多个相机,否则无法定位收益来源。
在目标设备的 Development Build 上,使用 Window > Analysis > Profiler 对比同一分辨率、相同视角下的 200 帧数据:记录 Rendering 模块的 Batches、SetPass Calls,以及平台支持时的 GPU 帧耗时中位数。示例记录可写为“Batches 210→145,GPU 18.2→15.0 ms”,这些是演示数据,不是固定预期。
Frame Debugger 负责解释一帧执行了哪些渲染事件,不能凭事件数直接推断 GPU 毫秒数。若 SetPass 下降而 GPU 时间不变,改善可能主要发生在 CPU 提交端;此时还需结合 GPU Profiler 或设备图形分析工具定位真正耗时的 Pass。