Version: 2022.3
性能分析器概述
常见性能分析器标记

应用程序性能分析

使用 Unity 性能分析器对应用程序进行性能分析时,可以通过三种主要方式记录数据:

  • 在目标平台上的播放器中对应用程序进行性能分析
  • 在 Unity 编辑器中以运行模式对应用程序进行性能分析
  • 对 Unity 编辑器进行性能分析

获得有关应用程序的准确时序的最佳方法是在打算发布它的终端平台上对它进行性能分析。这样可提供有关影响应用程序性能的因素的准确时序。

但是,每次要改进其性能元素时都构建应用程序可能会非常耗时。因此,要快速评估应用程序的性能,可以直接在编辑器中以运行模式对它进行性能分析。在运行模式下进行性能分析不会准确反映应用程序在真实设备上表现出的性能,但它是一个有用的工具,可在终端平台上进行初始分析后快速检查进行的更改是否可提高应用程序的性能。

Unity 编辑器可能会影响应用程序的性能,因为它在运行模式下运行时使用与应用程序相同的资源,因此还可以单独对编辑器进行性能分析以确定它使用的资源。如果应用程序仅设计为在运行模式下工作(例如用于电影制作),这会特别有用。

Profile your application on a target platform

要在目标发布平台上分析您的应用程序,请将目标设备连接到网络或通过线缆直接连接到计算机。还可以通过 IP 地址连接到设备。只能以开发版形式对应用程序进行性能分析。要进行此设置,请打开 Build Settings(菜单:File > Build Settings),然后选择应用程序的目标平台。启用 Development Build 设置。启用此设置后,与性能分析器相关的以下两个设置将变为可用状态:Autoconnect to ProfilerDeep Profiling Support

Build Settings 窗口,已启用性能分析选项
Build Settings 窗口,已启用性能分析选项

启用 Autoconnect Profiler 设置后,Unity 编辑器在构建过程中将自己的 IP 地址烘焙到已构建的播放器中。播放器启动时会尝试连接到位于所烘焙 IP 地址的编辑器中的性能分析器。

如果还启用了 Deep Profiling Support 设置,Unity 会在构建的播放器启动时执行深度性能分析,这意味着性能分析器会对代码的每个部分进行性能分析,而不仅仅是在 ProfilerMarker 中显式包裹的代码时序。这对于获取有关应用程序启动时间的深度性能分析信息很有用,但是,这会为构建增加少量开销。

在 Profiler 窗口中连接到播放器

To use the Profiler to manually connect to a platform running your application, configure the settings in the Attach to Player drop-down. You can only do this if Autoconnect Profiler is disabled.

For a platform to appear in the Attach to Player drop-down it must meet the following requirements:

  • The platform is visible on your local network or directly connected to your local machine by cable.
  • The platform is running a player that you built with the Development Build option enabled. For instructions on how to enable this setting for a platform, see Profile your application on a target platform.
  • The platform is running your Player.

The Attach to Player drop-down displays all Unity Players that Unity detects through the network or by direct connection. You can identify these Players by Player Name and the Product Name that is running the Player (for example, “iPhonePlayer (My iPhone)”).

You can also connect to a Player directly via its IP address. To do this, select the Attach to Player menu, and then select <Enter IP> in the dropdown. In the dialog box that appears, type the IP address and (optionally) the port of the Player you want to connect to.

To collect profiling information on your application, select the Player from the dropdown menu, and then click Record.

To continuously collect data while your application runs, enable the Run In Background setting in Player Settings (menu: Edit > Project Settings > Player > Resolution and Presentation). When you enable this setting, the Profiler collects data even when you leave your application running in the background. If you disable it, the Profiler only collects data when the application is running in an active window.

Using the Attach to Player search bar

The Attach to Player drop down includes a search bar that you can use to find information about your Player. You can search by Player Name or device category, for example Remote. When you search by category, the result displays all devices in that category.

Select the name of a development Player to view it in the profiler.

Attach to Player properties

Each column provides the following information about when it is available:

属性: 描述:
Player Name The name of the device that is running your application.

To change this name, navigate to Edit > Preferences > Analysis > Profiler and enter your desired name in the Custom Connection ID field.

You can also set a Player Name set when you launch a Player from the command line using the -connection-id argument.

For more information about the categories in this property, see Player name device categories
Product Name This is the value of the field that you set in Project > PlayerSettings.
IP The IP address of the Player.
Port The port of the Player.

Player name device categories

The Player Name category includes the following categories that display information about particular device types:

属性: 描述:
Play Mode Select this property to profile your application in Play Mode.
Edit Mode Select this property to profile the Unity Editor.
Local This list contains any device that is running on the local machine, in the Unity Editor or in a standalone player.

It also displays information for players that are physically connected to the host machine with a cable.
Remote This section displays information for devices running on the local network.

This section only appears when Unity finds a remote device running on the local network.
Connections without ID This section only appears when Unity finds a device running a player older than Unity 2021.2.
These players do not have Product Name, IP, or Port information.
Direct Connection Use this option to connect to a specific IP and port combination. This category displays the most recent IP you connected to.

平台特定性能分析指南

将不同平台连接到 Unity 性能分析器时,它们会具有不同的行为方式。以下部分提供有关每个平台的一些常见行为的指导:

WebGL

可以在 WebGL 中使用 Unity 性能分析器,但不能通过编辑器连接到使用 WebGL 构建的正在运行的播放器。这是因为 WebGL 使用 WebSocket 进行通信,所以不允许浏览器端的传入连接。要连接到运行的播放器,必须在 Build Settings(菜单:File > Build Settings)中启用 Autoconnect Profiler 复选框。Unity 无法对 WebGL 的绘制调用进行性能分析。

移动设备上的性能分析

iOS 和 Android 设备均支持通过网络进行远程性能分析。如果使用了防火墙,请在防火墙的出站规则中开放端口 54998 至 55511。这些是 Unity 用于远程性能分析的端口。

有时,在设置远程性能分析后,Unity 编辑器可能无法自动连接到设备。如果发生此情况,可以手动发起性能分析器连接。为此,请选择 Profiler 窗口中的 Attach to Player 下拉菜单,然后选择相应设备。

也可以将目标设备直接插入计算机以避免网络或连接问题。

iOS 远程性能分析

要对 iOS 设备启用远程性能分析,请遵循以下步骤:

  1. 将 iOS 设备连接到 WiFi 网络。性能分析器会使用本地 WiFi 网络将性能分析数据从设备发送到 Unity Editor。
  2. 通过线缆将设备连接到计算机。打开 Build Settings(菜单:File > Build Settings),选中 Development BuildAutoconnect Profiler 复选框,然后选择 Build & Run
  3. 应用程序在设备上启动时,请在 Unity 编辑器中打开 Profiler 窗口(菜单:Window > Analysis > Profiler)。

Android 远程性能分析

Android 设备支持两种远程性能分析方法:通过 WiFi 或通过 Android Debug Bridge (adb)

要进行 WiFi 性能分析,请遵循以下步骤:

  1. 在 Android 设备上禁用移动数据。
  2. 将 Android 设备连接到 WiFi 网络。性能分析器会使用本地 WiFi 网络将性能分析数据从设备发送到 Unity Editor。
  3. 通过线缆将设备连接到计算机。打开 Build Settings(菜单:File > Build Settings),选中 Development BuildAutoconnect Profiler 复选框,然后选择 Build & Run
  4. 应用程序在设备上启动时,请在 Unity 编辑器中打开 Profiler 窗口(菜单:Window > Analysis > Profiler)。

注意:Android 设备和主机(运行 Unity 编辑器)必须位于同一子网上才能正常进行设备检测。

要进行 Android Debug Bridge (adb) 性能分析,请遵循以下步骤:

  1. 确保设备处于开发模式并启用 USB debugging 设置
  2. 通过线缆将设备连接到计算机,并确保在 adb 设备列表中显示了该设备。
  3. 打开 Build Settings(菜单:File > Build Settings),选中 Development Build 复选框,然后选择 Build & Run
  4. 应用程序在设备上启动时,请在 Unity 编辑器中打开 Profiler 窗口(菜单:Window > Analysis > Profiler)。
  5. Attach to Player 下拉菜单中,选择 AndroidProfiler(ADB@127.0.0.1:34999)。仅当所选目标为 Android 时,下拉菜单中才会显示该条目。

选择 Build & Run 时,Unity Editor 会自动为应用程序创建 adb 隧道。如果要对另一应用程序进行性能分析,或者重新启动 adb 服务器,则需要手动配置此隧道。为此,请打开终端窗口或命令提示符窗口,并输入以下内容:

  • 通过 USB 线缆建立编辑器到 Android 的连接时需要

    adb forward tcp:34999 localabstract:Unity-{insert bundle identifier here}

  • 通过 USB 线缆建立 Android 到编辑器的连接时需要

    adb reverse tcp:34998 tcp:34999

要将深度性能分析用于 Android 构建,必须启用 Android Player Settings 中的 Mono Scripting Backend 设置(菜单:Edit > Project Settings > Player > Android > Other Settings),然后输入以下内容以便通过 adb 命令来启动游戏:

~$ adb shell am start -n {insert bundle identifier here}/com.unity3d.player.UnityPlayerActivity -e 'unity' '-deepprofiling'

Android ChromeOS remote profiling

Unity can’t automatically discover ChromeOS devices. To initiate a connection, connect to the device through Android Debug Bridge (adb) by its IP address and then select <Enter IP> from the Attach to Player drop-down menu and enter the device’s IP address. Once you have connected, you can profile your application as usual.

在 Unity 编辑器中进行性能分析

When you use the Profiler window to run and profile your application in the Editor, the results are only an approximation of your application’s behavior when the target platform runs it. This is because Play mode runs in the same process as the Editor, so you can’t fully isolate your application’s CPU, GPU, and memory usage from the Unity Editor’s usage. This skews the resulting profiling data.

要获得更好的性能分析结果,应该始终在目标设备上对应用程序进行性能分析,并且仅在编辑器中进行性能分析以快速迭代在设备上已确定的问题。

还可以在运行模式下进行性能分析或是对编辑器进行性能分析以确定与应用程序性能无关的问题,例如较长的加载时间或无响应的编辑器是否会减慢迭代时间,或者应用程序是否在运行模式下性能不佳。

Whenever you profile in the Editor, you should make sure that you open Play mode in maximized view, and reduce the amount of open Editor windows. This ensures that other Editor windows don’t use up time on the render thread and GPU, and therefore affect the performance data. When Play mode is in a maximized view it runs your application at a resolution closer to that of your target device, which directly affects performance issues such as those related to fill rate.

在运行模式下进行性能分析

性能分析器的默认目标是运行模式,这会在编辑器运行运行模式时记录活动。运行模式性能分析可用于测试快速更改而无需重新构建播放器,但是不应用于替代验证应用程序目标平台和设备上的构建。这是因为运行模式在与编辑器相同的应用程序和主线程中运行,这意味着在运行模式下进行性能分析时,编辑器的系统(例如 UI、Inspector、Scene 视图渲染和资源管理)会影响应用程序的性能和内存性能分析测量。

要在运行模式下有效地进行性能分析,应该定期构建应用程序并将它们部署到一系列目标设备(高规格和低规格设备),并在这些设备上对应用程序进行测试和性能分析。如果在这些设备上发现应用程序方面的性能问题,请缩小最需要关注的区域。

随后可以在运行模式下对应用程序进行性能分析,并快速迭代对应用程序进行的任何更改。可以使用通过在目标设备上对应用程序进行性能分析而获得的信息来确定在运行模式下对应用程序进行性能分析后是否存在任何类似行为。随后可以更改应用程序,并再次在运行模式下进行性能分析以快速查看更改所产生的效果。一旦对更改感到满意,请再次构建应用程序并部署到目标设备以验证更改。

PlayerLoop 和 EditorLoop 样本

为了减少编辑器在运行运行模式时创建的性能分析数据中的噪声和误导性测量数量,CPU 和 GPU 性能分析器模块将其时序拆分为在 PlayerLoopEditorLoop 中发生的时序。Unity 会向这些类型的性能分析器样本分配 PlayerLoop 和 EditorLoop 标记

当性能分析器以运行模式为目标时,它只收集发生在 PlayerLoop 内部发生的时序样本。

CPU 性能分析器模块图表中,Unity 将所有 EditorLoop 样本都分类为 Others。因此,EditorLoop 样本是该类别的最大贡献者。如果想了解编辑器在这段时间内的操作,并且还想获得有关 Others 类别的其他贡献者的更详细细分,请将性能分析器目标更改为编辑器。

Important: If you use Deep Profiling, and target Play mode, it has a performance impact on every function call that happens in both PlayerLoop and EditorLoop. This is because Deep Profiling hooks into the beginning and end of any scripting method call on domain reload and it doesn’t detect which parts are never called from the PlayerLoop. The method calls that happen in the EditorLoop don’t incur the full overhead of creating a sample, but they still check if they should emit one, which causes a smaller but still present overhead.

对编辑器进行性能分析

将性能分析器的目标更改为编辑器时,之前隐藏在 EditorLoop 标记下的所有样本都会归类到其各自的类别中。这意味着 CPU 性能分析器模块详细信息面板及其图表中的信息会显著更改。

要对编辑器的启动时间进行性能分析,请使用命令行选项 -profiler-enable 启动编辑器。

要减少 Profiler 窗口对编辑器性能的影响,可以使用独立性能分析器(它会在自己的进程中打开 Profiler 窗口)。如果选择编辑器作为性能分析目标,或是对应用程序进行深度性能分析,那么这会尤其有用,因为 Profiler 窗口本身通常使用可能会使性能数据出现偏差的资源。

对应用程序进行性能分析的最佳实践

对应用程序进行性能分析时,可以采取一些措施来确保性能分析会话之间的一致性,并确保 Unity 使用的进程不会影响性能分析数据:

  • 只添加与要调查到 Profiler 窗口的区域相关的性能分析器模块。要向性能分析器添加和移除模块,请选择 Profiler 窗口左上角的下拉选单。
  • 避免使用深度性能分析,因为它会在使用时产生较高开销。如果要查看有关带有标记(如 GC.Alloc 或 JobFence.Complete)的样本的更多详细信息,请导航到 Profiler 窗口工具栏并启用 Call Stacks 设置。这可提供样本的完整调用栈,其中会提供所需信息,而不会产生深度性能分析的开销。
  • Disable the Live setting if you don’t need to see the Hierarchy or Timeline view updating as the Profiler collects data. Stop recording to see the data update to the window.
  • 使用 F9 快捷键启用或禁用性能分析器。可以使用此快捷键捕获性能数据,而无需打开 Profiler 窗口。如果打开了独立性能分析器,则使用此快捷键会在此窗口中开始记录。

  • 2019.3 中添加了 Deep Profiling Support NewIn20193
性能分析器概述
常见性能分析器标记