文档

Unity 引擎

Unity 引擎

RenderDoc 集成

使用 RenderDoc 调试器可以 ON 逐帧调试图形。
阅读时间5 分钟最后更新于 10 天前

Editor 支持集成启动和捕获 RenderDoc 图形调试器,以便进行详细的帧内省和调试。
仅 RenderDoc 0.26 或更高版本支持集成,因此如果当前安装了早期版本,则需要至少更新到 0.26 版本。
注意
虽然集成仅在 Editor 中可用,但完全可以像法线一样使用 RenderDoc,无需在独立平台播放器构建中进行额外设置。
注意
仅当 Unity ON RenderDoc 支持的平台和 API 上running时,才能捕帧。如果正在使用另一个 API,则会暂时Disabled RenderDoc 集成,直到已启用支持的 API。请参阅 RenderDoc 文档以了解有关支持的平台和 API 的更多信息。

加载中 RenderDoc

如果检测到 RenderDoc 安装,则在 Editor 加载后的 Any 时间,都可以右键单击 Game View 或 场景视图的选项卡,然后单击“加载 RenderDoc”选项。这将重新加载图形设备,因此必须 Save Any 更改,但随后 RenderDoc 将准备好捕获,而无需重新启动 Editor 或独立平台播放器版本。
注意
您也可以通过 RenderDoc 正常启动 Editor,或通道 -load-renderdoc 命令行选项以在启动时加载 RenderDoc。

使用 RenderDoc 捕获帧

当检测到兼容版本的 RenderDoc 已加载到 Editor 中时,工具栏右侧 ON Game 和 Scene 视图将显示新建按钮。

Capturing a frame with RenderDoc

按下此按钮触发器Viewew图的Next帧渲染。如果 RenderDoc 工具 UI 尚未打开,则会启动一个新建实例来显示捕获,如果已在running,则最新捕获将自动显示在此处。从此处可以使用 工具Open捕获和调试。

List of frame captures in RenderDoc

包含着色器调试信息

默认情况下,为了优化 DirectX11 着色器的大小,会删除调试信息。这意味着常量和资源没有名称,着色音频源频源不可用。要在着色器中包含此调试信息,请在着色器的
HLSLPROGRAM
代码块中包含**# pragma enable_d3d11_debug_symbols**。

替代图形调试技术

如果使用 D3D11 版本独立平台播放器,可以使用 Visual Studio 图形调试器捕获帧并进行调试。

在 RenderDoc 中配置 Android SDK

使用 RenderDoc 开发 Android Applications程序When,请确保使用以下方式之一正确配置 Android SDK:

将 RenderDoc 设置为与 Unity 使用相同的 SDK(推荐)

  1. 在 RenderDoc 窗口中,转到 Tools > Settings > Android。
  2. 在 Android SDK 根路径下,进入 Unity 用于 Android SDK 的路径。可在 Unity Editor 的 Edit > 偏好设置 > Android SDK 工具下查找此路径。

在 RenderDoc 和 Unity 之间对齐 ADB 版本和路径

如果未设置 RenderDoc Settings 中的 Android SDK 根路径,RenderDoc 将使用
PATH
Environment 变量中为 ADB 设置的路径。
  1. 查找
    PATH
    变量中设置的 ADB 路径。
    • Windows PowerShell:
      Get-Command adb | Select-Object Path
    • Windows 命令提示符:
      where adb
  2. 在 Windows Terminal 中检查 ADB 版本:
    C:\[adb path from command output]\adb.exe version
    。
  3. 查找 Unity 使用的 ADB 路径。在 Unity Editor 中,转到 Edit > 偏好设置 > Android SDK 工具。
  4. 在 Windows Terminal 中检查相应的 ADB 版本:
    C:\[path to Android sdk platform-tools]\adb.exe version
    。
  5. 比较 RenderDoc 和 Unity 使用的 ADB 版本。如果不同,请选择其中一个 ADB 位置,并将两个工具配置为使用相同的路径。
注意
使用 Android Studio 中的 Android SDK 管理器,确保选定 SDK 中的平台工具是最新的。