UE4 stats文件Profiler工具

Profiler工具的代码详见：UnrealEngine\Engine\Source\Developer\Profiler

UE4提供了2种使用Profiler工具的方式：

① UE4编辑器中的Session Frontend面板，见菜单“Window” -- “Developer Tools” -- “Session Frontend”

② 独立的UnrealFrontend工具

离线模式

控制台命令抓取性能数据并保存到文件

stat startfile // starts a stats capture, creating a new file in the Profiling directory; stop with stat StopFile to close the file

stat stopfile // stops dumping a capture (regular, raw, memory). finishes a stats capture started by stat StartFile

stat startfileraw // starts dumping a raw capture. 4.26版本可以生成ue4statsraw文件，但是Profiler工具不能支持该文件的读取注：详见FProfilerManager::LoadRawStatsFile函数

stat stopfileraw // 功能与stat stopfile一致

UE4Editor.exe "%GameDir%\MyGame.uproject" TestMap_Main -game -ExecCmds="stat startfile" // 启动游戏后，然后执行stat startfile命令

ue4stat文件保存在：Saved\Profiling\UnrealStats目录中

在代码中开启和关闭stat文件

#if STATS
    DirectStatsCommand(TEXT("stat startfile"));
#endif

#if STATS
    DirectStatsCommand(TEXT("stat stopfile"),true);
#endif

Profiler工具读取性能数据

在Frontend工具中的Profiler标签下，点击Load来读取ue4stat文件

也可以点击Load Folder来加载某个目录下的所有ue4stat文件

注：红框处会列出所有的ue4stat文件，点击即可切换

实时模式

首先需要在uproject文件中启用TcpMessaging、UdpMessaging插件注：默认会启用，但uproject中可将其关闭

本机或USB数据线的连接模式

游戏侧

UE4Editor.exe %GameDir%\MyGame.uproject -skipcompile // 编辑器

UE4Editor.exe %GameDir%\MyGame.uproject ThirdPersonExampleMap -messaging -SessionName=mySession -game -skipcompile // standalone单机对本机或USB数据线连接的机器上的UnrealFrontend可见

Profiler工具侧

UE4Editor.exe %GameDir%\MyGame.uproject -skipcompile

UnrealFrontend.exe

同一wifi网络的连接模式

游戏侧

PC：UE4Editor.exe %GameDir%\MyGame.uproject ThirdPersonExampleMap -messaging -SessionName=mySession -TcpMessagingConnect=10.46.80.61:7777 -game -skipcompile // 以standalone启动ThirdPersonExampleMap地图，并连接到10.46.80.61:7777

Android：UE4CommandLine.txt写入如下内容，并adb push到手机的UE4Game/UAGame目录中

-messaging TcpMessagingConnect=10.46.80.61:7777 -SessionOwner=kekec -SessionName=fps1

IOS：ue4commandline.txt（注：要全小写）写入与Android一样的内容，并放到如下目录中

日志窗口默认会Follow Scroll来显示最新的日志输出，若想看上面的日志，可按Home键将光标移到顶部，然后再滚动到自己想看的地方

若想继续Follow Scroll，按End键将光标移到底部即可

Profiler工具侧

UE4Editor.exe %GameDir%\MyGame.uproject -TcpMessagingListen=10.46.80.61:7777 -SessionOwner=kekec -skipcompile // 启动编辑器并监听10.46.80.61:7777 注：10.46.80.61为编辑器所在机器的IP kekec为当前计算机的登录用户名

UnrealFrontend.exe -TcpMessagingListen=10.46.80.61:7777 -SessionOwner=kekec // 启动UnrealFrontend.exe并监听10.46.80.61:7777 注：10.46.80.61为UnrealFrontend所在机器的IP kekec为当前计算机的登录用户名