path | 内存快照文件的目标路径。 |
finishCallback | 一旦内存快照完成捕获数据进程便会触发的事件。 |
captureFlags | 定义内存快照内容的标志掩码。 |
screenshotCallback | 您可以在快照完成后指定该事件以检索屏幕截图。 |
触发内存快照捕获。
使用提供的参数请求内存快照捕获。并非与捕获标志相对应的所有字段均被收集。这取决于用于捕获快照的目标构建。系统中有两种不同的数据收集行为
* 当您直接从播放器或在编辑器中调用此功能时,此进程会同步在主机设备上创建内存快照文件。注意:这要求未连接任何分析目标。如果已向 MemoryProfiler.CreatingMetadata 注册至少一个收集后备,则会执行元数据收集。进程结束后,会触发 MemoryProfiler.SnapshotFinished。
* 在编辑器中调用此函数时,并且您已连接到分析目标,此进程会在主机设备上异步创建内存快照文件,并将捕获请求发送到远程目标。然后,目标设备将使用已注册到 MemoryProfiler.CreatingMetadata 的回调收集元数据。您必须在分析目标的本地程序集中定义回调,并在发送捕获事件之前在运行时注册这些回调。所有捕获数据都会从远程目标流式传输到编辑器。当捕获进程完成后,编辑器内将触发快照完成回调。如果在调用期间提供了屏幕截图回调,则此回调将在当前帧的末尾调用。
注意:* 仅在独立播放器或播放模式中调用屏幕截图回调。