版本:Unity 6 (6000.0)
语言英语
  • C#

MemoryProfiler.TakeSnapshot

提出更改建议

成功!

感谢您帮助我们提高 Unity 文档的质量。虽然我们无法接受所有提交,但确实会阅读我们用户提出的每项更改建议并在必要时进行更新。

关闭

提交失败

由于某些原因,您的更改建议无法提交。请在几分钟后<a>重试</a>。感谢您抽出时间帮助我们提高 Unity 文档的质量。

关闭

取消

声明

public static void TakeSnapshot(string path, Action<string,bool> finishCallback, Unity.Profiling.Memory.CaptureFlags captureFlags);

声明

public static void TakeSnapshot(string path, Action<string,bool> finishCallback, Action<string,bool,DebugScreenCapture> screenshotCallback, Unity.Profiling.Memory.CaptureFlags captureFlags);

参数

path 内存快照文件的目标路径。
finishCallback 一旦内存快照完成捕获数据进程便会触发的事件。
captureFlags 定义内存快照内容的标志掩码。
screenshotCallback 您可以在快照完成后指定该事件以检索屏幕截图。

说明

触发内存快照捕获。

使用提供的参数请求内存快照捕获。并非与捕获标志相对应的所有字段均被收集。这取决于用于捕获快照的目标构建。系统中有两种不同的数据收集行为

* 当您直接从播放器或在编辑器中调用此功能时,此进程会同步在主机设备上创建内存快照文件。注意:这要求未连接任何分析目标。如果已向 MemoryProfiler.CreatingMetadata 注册至少一个收集后备,则会执行元数据收集。进程结束后,会触发 MemoryProfiler.SnapshotFinished。

* 在编辑器中调用此函数时,并且您已连接到分析目标,此进程会在主机设备上异步创建内存快照文件,并将捕获请求发送到远程目标。然后,目标设备将使用已注册到 MemoryProfiler.CreatingMetadata 的回调收集元数据。您必须在分析目标的本地程序集中定义回调,并在发送捕获事件之前在运行时注册这些回调。所有捕获数据都会从远程目标流式传输到编辑器。当捕获进程完成后,编辑器内将触发快照完成回调。如果在调用期间提供了屏幕截图回调,则此回调将在当前帧的末尾调用。

注意:* 仅在独立播放器或播放模式中调用屏幕截图回调。