使用 Unreal Insights 进行分析

Unreal Insights 是一个分析系统,用于从 Unreal Engine 收集、分析和可视化数据。 该分析系统可帮助你找到优化瓶颈,以及应用程序的性能在哪些方面可以得到提升。 通常可以直接从编辑器中启用 Unreal Insights,但对于 HoloLens 2,则需要使用命令行。

安装

Unreal 允许通过用于启用 Unreal Insights 的命令行参数在 HoloLens 启动器中创建和配置“自定义配置文件”。

  1. 在命令提示符下使用 ipconfig 命令查找计算机的 IP 地址。 IP 地址是 ipconfig 列出的 IPv4 地址。 稍后在设置命令行参数时请记住这一点。

重要

如果使用 VPN,则可能需要改为提供通过 VPN 提供的 IP 地址。

Screenshot of command line results for ipconfig command

  1. 从主编辑器窗口中的“编辑”工具栏打开“项目设置”

Screenshot of Edit dropdown with Project Settings highlighted

  1. 向下滚动左侧面板,直到看到“平台”标题,然后选择“HoloLens”

Screenshot of the Platforms section in the Project Settings left panel with HoloLens highlighted

  1. 确认在“功能”部分选择了“Internet 客户端”、“Internet 客户端服务器”和“专用网络客户端服务器”

Screenshot of Capabilities options with Internet Client, Internet Client Server, and Private Network Client Server selected

启动

  1. 通过 UE4 面板中的“启动”按钮打开“项目启动器”

Screenshot of launch options with project launcher highlighted

  1. 选择 + 按钮以在“自定义启动配置文件”下创建自定义配置文件。 创建后,可以随时编辑此配置文件:

Screenshot of project launcher with custom launch profiles highlighted

  1. 在 HoloLens 自定义启动配置文件中选择“编辑配置文件”按钮。 在“生成”部分,选中“生成 UAT”并设置“其他命令行参数”
    • 初学者请尝试以下参数:-tracehost=IP_OF_YOUR_PC -trace=Log,Bookmark,Frame,CPU,GPU,LoadTime,File,Net
    • 可以在 Unreal Insights 参考文档中找到可用启动参数的完整列表。

注意

“IP_OF_YOUR_PC”是我们在步骤 1 中找到的 IP 地址。 这是运行 Unreal Insights 的计算机的 IP 地址,而不是 HoloLens 的 IP 地址。

重要

跟踪很快就会变大。 请仅启用那些需要保留较小跟踪大小的通道。

Screenshot of Build options in profile configuration

  1. 选择“按书籍”旁边的“烹调”以启用复制到设备的功能。 确保在“烹调地图”中选择了地图

Screenshot of cook options in profile configuration with cook by the book and HoloLens highlighted

  1. 将“想要如何打包生成”设置为“打包并在本地存储”。 请记下所选的文件路径,因为稍后需要用到。

Screenshot of package options in profile configuration set to package and store locally

  1. 将“想要如何部署生成?”设置为“不部署”

Screenshot of deploy options in profile configuration with deploy set to do not deploy

  1. 选择“返回”以返回“项目启动器”对话框的根位置
  2. 返回编辑器,在自定义启动配置文件中单击“启动”

Screenshot of custom launch profiles

  1. 观察项目的生成过程,然后通过设备门户将 appxbundle(在步骤 5 选择的包路径中)部署到 HoloLens

  2. 启动 Unreal Insights。 Unreal Insights 可执行文件存储在二进制引擎文件夹中,通常位于以下位置:“C:\Program Files\Epic Games\UE_4.26\Engine\Binaries\Win64\UnrealInsights.exe”

Screenshot of unreal insights executable running

  1. 在 HoloLens 上启动应用。

分析

返回 Unreal Insights,选择与设备的“实时”连接以开始分析

自定义配置文件在项目之间共享。 从现在开始,你可以使用创建的自定义配置文件,而不必每次都创建配置文件。 只需在每次启动 Unreal 时,使用设置部分中的步骤 3 到 6 重新创建与设备的连接。

另请参阅