创建性能分析器模块
将自定义定义性能性能分析器模块添加到 性能分析器 窗口可收集和显示有关应用程序程序的指定的数据。
阅读时间6 分钟最后更新于 6 天前
性能分析器模块在 性能分析器 窗口中显示System的性能数据。
您可以通过以下方式之一创建自己的性能分析器模块:
- 使用性能分析器模块 Editor。
- 创建 脚本
自定义定义模块在 性能分析器 窗口图表View (A) 中显示您在代码中指定的计数器,而计数器在模块细节信息面板 (B) 中显示为列表。

A custom Profiler module with custom data displayed.
使用 性能分析器模块 Editor 创建 性能分析器模块
您可以使用 Unity 的内置性能分析器模块 Editor 来创建自己的性能分析器模块。要在性能分析器模块中收集数据,必须为要轨道的模块添加至少一个计数器。您可以添加两个内置 Unity 计数器,或使用 API 创建自己的计数器以添加到模块。可用计数器列表显示在 Available Counters 面板中。
ProfilerCounter要创建自己的模块:
- 打开性能分析器窗口(窗口 > Analysis > Performance Analytics)。
- 选择 性能分析器 模块 Dropdown选单,然后选择齿轮图标。此时将打开 性能分析器模块 Editor。
- 选择窗口左下角的添加按钮。然后 Unity 将新建性能分析器模块添加到列表中,称为**新建性能分析器模块。**重命名模块,请单击Text Field并使用键盘设置Name。
- 从 Available Counters 面板选择要在模块中显示的计数器,然后双击 ON 将它们添加到模块中。要选择多个个计数器,请按住 Shift 并单击以选择一个范围,或按住 Ctrl(macOS ON的 Command)以一时间选择一个计数器。
- 要重新排序计数器,请Drag它们。一个模块最多只能添加 10 个计数器。
- 选择 性能分析器模块 Editor 窗口右底部的 Save Changes 按钮。Unity 关闭窗口,Unity 在 性能分析器 窗口中显示新建模块。
在代码中创建 性能分析器模块
要通过代码创建性能分析器模块,必须新建脚本并定义模块的 Properties,包括其显示的计数器、Name 和图标。
ProfilerModule要定义性能分析器模块,脚本必须执行以下操作:
-
定义从 Project 或包中的派生的类。在以下示例中,该类称为
ProfilerModule:TankEffectsProfilerModulepublic class TankEffectsProfilerModule : ProfilerModule -
将属性分配给该类并在属性的参数中指定模块的 Display Name。在以下示例中,Display Name为“坦克特效”:
[ProfilerModuleMetadata][ProfilerModuleMetadata("Tank Effects")] -
实现一个没有参数的构造函数函数,并将图表计数器Descriptions的列表通道给底部构造函数。在以下示例中,没有参数的构造函数为,图表计数器描述符列表为
TankEffectsProfilerModule(),底部构造函数为k_Counters:baseStatic 只读 ProfilerCounterDescriptor[] k_Counters = 新建 ProfilerCounterDescriptor[]{ 新建 ProfilerCounterDescriptor(GameStatistics.TankTrailParticleCountName, GameStatistics.TanksCategory), 新建 ProfilerCounterDescriptor(GameStatistics.ShellExplosionParticleCountName, GameStatistics.TanksCategory), 新建 ProfilerCounterDescriptor(GameStatistics.TankExplosionParticleCountName, GameStatistics.TanksCategory),}; public TankEffectsProfilerModule() : base(k_Counters) { }
在 性能分析器 窗口中显示自定义定义 配置文件 模块
定义自己的性能分析性能分析器模块When,性能分析器 窗口会自动检测该模块。要在 性能分析器 窗口中View 性能分析器模块中的数据,请执行以下操作:
- 将性能性能分析器连接到应用程序程序。有关更多信息,请参阅分析应用程序。
- 运行应用程序。
还可以在应用程序程序处于播放模式When运行性能性能分析器。但是,如果在播放模式下对应用程序程序进行性能配置文件,则性能分析器显示的数据不能代表ON硬件设备上版本应用程序程序When的运行方式。