调试虚拟资产

本页面介绍了如何查看有关项目中的 虚拟资产（Virtual Assets） 的信息和调试输出。

验证你的虚拟化数据包

要确定你的数据包是否已成功虚拟化，请将鼠标悬停在内容浏览器中的资产上，然后勾选 有虚拟化数据（Has Virtualized Data） 条目。

你也可以查看资产的文件大小。如果 .uasset 文件比虚拟化之前显著变小，则批量数据已从 .uasset 分离，并已包含在 Saved/VirtualizedPayloads 目录中。

要调查数据包文件的内容，请右键点击 内容浏览器（Content Browser） 中的资产，点击 复制文件路径（Copy File Path） ，然后在控制台中输入以下命令：

    DumpPackagePayloadInfo [文件路径]

Copy full snippet

DumpPackagePayloadInfo [文件路径]

将 [file path] 替换为你从内容浏览器复制的文件路径。

此控制台命令可以采用完整路径或数据包路径，并将在输出窗口中编写有效负载的摘要。 输出会显示本地存储的有效负载的列表，然后是虚拟化有效负载的列表。

DumpPackagePayloadInfo不会使用缓存的信息，例如资产注册表。相反，它会在你每次使用它时重新解析数据包的信息，这样它提供的信息应该始终是最新的。

使用统计数据面板监控虚拟资产

统计数据面板（Statistics Panel） 将显示有关虚拟资产在你的计算机上如何表现的信息。你可以在 工具（Tool） > 审核（Audit） > 虚拟资产（Virtual Assets） 中找到此面板。

虚拟资产统计数据面板。当前面板将显示两个不同后端的读取、写入和缓存统计数据：DDC后端和项目的源码控制。

"虚拟资产（Virtual Assets）"选项卡中的每行表示不同的后端，基于你的配置文件设置，这应该易于识别。虚幻引擎记录了以下内容的统计数据：

• 读取（Read） 根据需要从后端提取有效负载。

  写入（Write）

• 在虚拟化时将有效负载推送到后端。

  缓存（Cache）

• 从更慢的后端（例如源码控制系统）提取有效负载时，它会推送到更快的后端，这样重复访问会更快。

调试命令参考

此分段提供了调试命令，用于调试 虚幻引擎（Unreal Engine） 中的 虚拟资产（Virtual Asset） 系统。它在适用的情况下为虚幻编辑器中的命令行和控制台窗口提供了命令。命令行中使用的大部分命令还可以在你的配置文件中使用。你还可以在虚拟化图表中使用这些命令的命令行版本。

禁用虚拟资产系统

• 命令行： -VADisable
• 控制台： VA.DisableVirtualization

禁用虚拟化系统并改为挂载空实现。

这相当于将 DefaultEngine.ini 文件中的 [Core.ContentVirtualization] 分段中的 SystemName 设置为 None 。

禁用后，虚拟化系统接口中的所有方法都将返回其失败状态。

覆盖BackendGraph

• 命令行： -VABackendGraph=

更改虚拟化系统在初始化时使用的后端图表，就好像你在编辑 DefaultEngine.ini文件中的 [Core.ContentVirtualization] 分段的"BackendGraph"值

图表的名称必须匹配为你尝试运行的项目设置的现有图表。如果它不存在，则虚拟化系统会在启动时显示致命错误。

禁用特定后端

• 命令行： -VAMissBackends=[后端名称]
• 控制台： VA.MissBackends

完全禁止一个或多个后端提取有效负载。此命令可能采用以下任意输入：

模拟错误连接

• 命令行： `-VAMissChance=[失败的百分比几率]
• 控制台： VA.MissChance

设置有效负载提取将自动失败的百分比几率，以模拟错误连接。例如， -VA-MissChance=50 将设置50%的失败几率。

使指定数量的有效负载提取失败

• 控制台： VA.MissCount=[要错过的有效负载提取次数]

自动错过后续 X 次有效负载提取，其中 X 是你使用此命令指定的数字。

VA.MissCount 没有命令行版本。

验证有效负载推送

• 命令行： -VAValidatePushes
• 控制台： VA.ValidatePushes

在每次推送后提取有效负载并与原始文件比较来验证有效负载。这相当于在 DefaultEngine.ini 文件中设置 ValidateAfterPushOperation 选项。

强制采用单线程模式

• 命令行： -VASingleThreaded
• 控制台： VA.SingleThreaded

强制系统以单线程模式工作，排除了作为潜在漏洞来源的多线程访问。这相当于在 DefaultEngine.ini 文件中设置 ForceSingleThreaded 选项。

日志记录

当虚拟化系统初始化时，会有详细日志显示启用的选项和设置。这包括在某个事项未正确设置并有可能造成严重数据故障时的致命日志消息。

默认情况下，日志记录会尽量减少，并且仅应该在恰当时显示警告和错误。但是，如果你启用 详细日志记录 ，日志将显示在调试问题时很有用的额外信息。

要启用日志记录，请在命令行上使用以下命令：

-LogCmds="LogVirtualization Verbose"
-ini:Engine:[Core.Log]:LogVirtualization=Verbose"
Copy full snippet

-LogCmds="LogVirtualization Verbose" -ini:Engine:[Core.Log]:LogVirtualization=Verbose"