概述
游戏性分析器是个工具,它在分析会话过程中利用了捕获的数据,使您可以更深入地挖掘游戏性代码来分析执行函数所花费的时间。它可以替换Script Profiler(脚本分析器)。
创建Profile
任何时候,您都可以通过在控制台运行 PROFILEGAME START
控制台命令来开始对游戏性进行分析,通过运行 PROFILEGAME STOP
命令来停止分析。可替换地,您可以使用 PROFILEGAME 10
来捕获10秒钟的游戏性。
这将会在您的游戏 [GameName]\Profiling\\
文件夹中写入一个 .gprof
文件,游戏机平台的文件将会自动地复制到主机PC上。需要注意的是文件很快就会变得很大,所以最好进分析热点区域附近,大约10-30秒即可。
查看Profile
启动游戏性分析器可执行文件 GameplayProfiler.exe
,然后按下 File Open(打开文件) 按钮并导航到你想打开的.gprof文件或者简单地在命令行中传入文件名称。
注意 : 游戏性分析器的可执行文件可以在UE3或UDK发布包的Binaries目录中找到。
输出
加载并分析完数据文件后,将会通过几个选卡为您呈现一个具有时间和帧数的图表,显示了以各种方式细分的当前帧的分析数据。
默认选择帧0。通过在图表中左击或者手动地在图表上方的 Frame(帧) 文本域中输入帧编号来选择一个新帧。当前帧在图表中高亮显示为红色的垂直线。
您可以通过按下鼠标左键并进行拖拽来在您想查看的区域上创建区域选择来在图表上进行放大。点击帧轴左侧的小圆圈或者时间轴顶部将会沿着各自的轴缩回原样。
图表中的绿色线显示了帧时间,以毫秒为单位,蓝色线显示了跟踪的actor的 tick(更新)/脚本 时间以及它和帧时间的关系。比如,并不是所有的峰值都和脚本或游戏性更新有关,这允许我们辨别并跟踪那些和脚本或游戏性有关的峰值。
Time Threshold(时间阈值) 可以使得仅显示超出那个时间的数据。您可以使用该项来仅显示某个数量级的事件,从而使得找到问题区域变得更加容易。
当启用 Show Native Timing Data(显示Native时间数据) 时,则除了显示脚本时间数据外还会显示循环计数器范围中花费的时间。这个数据一般要求使用StatsViewer进行分析。可以在游戏性分析器中直接地随同脚本数据一同查看该数据使得跟踪问题变得更加简单和快速。
在标签中显示的数据是具有颜色编码区分的,使得您更加容易地知道它是哪种类型的数据。
数据类型是:
- 蓝色 - 脚本函数
- 红色 - Native代码
- 紫色 - 关卡
- 绿色 - Actors
- 橄榄色 - 组件
- 橙色 - 类
同时,将会显示任何相关资源的名称。比如,如果数据是针对SkeletalMeshComponent(骨架网格物体组件)的,那么将会显示应用到该组件上的骨架网格物体的名称。
Actor/类 的调用图表
这个视图分割为了两个单独的调用图表。左侧是选中帧的 level(关卡) -> actor -> component(组件)/ function(函数) 层次机构,它分别地显示了每个实例;右侧是按照actor class(actor类别) -> actor -> component(组件)/ function(函数)进行分组的。
您可以使用左侧来查看多关卡情境下哪个关卡是热点关卡(通常会在永久性关卡中产生一个对象)或者查看某些对象的相对消耗。
当您正在调查哪种类型的对象消耗时间时右侧的视图是有用的,同时在该视图中您也可以看到这里具有的某个类的实例个数。那里显示的inclusive(非独占)和exclusive (独占)数值代表着在剔除前树结构中inclusive(非独占的)和exclusive (独占的)子节点的数量。较大的inclusive(非独占的)值通常意味着调用了大量的不同的脚本函数。
Function summary(函数概述)
这个视图显示了选中帧中调用的每个脚本函数,及它们的独占时间和非独占时间,每个函数的调用次数及其独占时间和非独占时间的比率。您可以简单地点击某一栏,使它按降序排列。唯一的例外是函数名称栏,它总是按照升序排列。
Class hierarchy(Class的层次结构)
Class的层次结构是基于每个类的视图,它把性能消耗具体到actor、actor组件和函数顶层节点上。需要注意的是大多数actor组件和函数所占用时间已经考虑载了actor时间中,所以您不能简单地把它们相加。
这个视图可以用于简单地查看类的层次结构,比如,查看更新AI花费了多少时间或者在执行UnrealScript是花费了多少时间。
Function call graph(函数调用图)
这个标签面板显示了当前选中帧的函数调用图。
Aggregate function summary(合计函数概要)
这个标签面板和function summary(函数概要)面板类似,只是它把整个捕获的时间间隔的信息聚集到一起了。它把独占时间、非独占时间和函数调用数量聚集起来,最大独占时间和最大非独占时间分别是单独帧的最大值,其它的值是帧平均值。
合计的函数调用图表
所有执行的函数的调用图表,是在整个捕获期间的函数调用的合计信息。
概述
游戏性分析器是个工具,它在分析会话过程中利用了捕获的数据,使您可以更深入地挖掘游戏性代码来分析执行函数所花费的时间。它可以替换Script Profiler(脚本分析器)。
创建Profile
任何时候,您都可以通过在控制台运行 PROFILEGAME START
控制台命令来开始对游戏性进行分析,通过运行 PROFILEGAME STOP
命令来停止分析。可替换地,您可以使用 PROFILEGAME 10
来捕获10秒钟的游戏性。
这将会在您的游戏 [GameName]\Profiling\\
文件夹中写入一个 .gprof
文件,游戏机平台的文件将会自动地复制到主机PC上。需要注意的是文件很快就会变得很大,所以最好进分析热点区域附近,大约10-30秒即可。
查看Profile
启动游戏性分析器可执行文件 GameplayProfiler.exe
,然后按下 File Open(打开文件) 按钮并导航到你想打开的.gprof文件或者简单地在命令行中传入文件名称。
注意 : 游戏性分析器的可执行文件可以在UE3或UDK发布包的Binaries目录中找到。
输出
加载并分析完数据文件后,将会通过几个选卡为您呈现一个具有时间和帧数的图表,显示了以各种方式细分的当前帧的分析数据。
默认选择帧0。通过在图表中左击或者手动地在图表上方的 Frame(帧) 文本域中输入帧编号来选择一个新帧。当前帧在图表中高亮显示为红色的垂直线。
您可以通过按下鼠标左键并进行拖拽来在您想查看的区域上创建区域选择来在图表上进行放大。点击帧轴左侧的小圆圈或者时间轴顶部将会沿着各自的轴缩回原样。
图表中的绿色线显示了帧时间,以毫秒为单位,蓝色线显示了跟踪的actor的 tick(更新)/脚本 时间以及它和帧时间的关系。比如,并不是所有的峰值都和脚本或游戏性更新有关,这允许我们辨别并跟踪那些和脚本或游戏性有关的峰值。
Time Threshold(时间阈值) 可以使得仅显示超出那个时间的数据。您可以使用该项来仅显示某个数量级的事件,从而使得找到问题区域变得更加容易。
当启用 Show Native Timing Data(显示Native时间数据) 时,则除了显示脚本时间数据外还会显示循环计数器范围中花费的时间。这个数据一般要求使用StatsViewer进行分析。可以在游戏性分析器中直接地随同脚本数据一同查看该数据使得跟踪问题变得更加简单和快速。
在标签中显示的数据是具有颜色编码区分的,使得您更加容易地知道它是哪种类型的数据。
数据类型是:
- 蓝色 - 脚本函数
- 红色 - Native代码
- 紫色 - 关卡
- 绿色 - Actors
- 橄榄色 - 组件
- 橙色 - 类
同时,将会显示任何相关资源的名称。比如,如果数据是针对SkeletalMeshComponent(骨架网格物体组件)的,那么将会显示应用到该组件上的骨架网格物体的名称。
Actor/类 的调用图表
这个视图分割为了两个单独的调用图表。左侧是选中帧的 level(关卡) -> actor -> component(组件)/ function(函数) 层次机构,它分别地显示了每个实例;右侧是按照actor class(actor类别) -> actor -> component(组件)/ function(函数)进行分组的。
您可以使用左侧来查看多关卡情境下哪个关卡是热点关卡(通常会在永久性关卡中产生一个对象)或者查看某些对象的相对消耗。
当您正在调查哪种类型的对象消耗时间时右侧的视图是有用的,同时在该视图中您也可以看到这里具有的某个类的实例个数。那里显示的inclusive(非独占)和exclusive (独占)数值代表着在剔除前树结构中inclusive(非独占的)和exclusive (独占的)子节点的数量。较大的inclusive(非独占的)值通常意味着调用了大量的不同的脚本函数。
Function summary(函数概述)
这个视图显示了选中帧中调用的每个脚本函数,及它们的独占时间和非独占时间,每个函数的调用次数及其独占时间和非独占时间的比率。您可以简单地点击某一栏,使它按降序排列。唯一的例外是函数名称栏,它总是按照升序排列。
Class hierarchy(Class的层次结构)
Class的层次结构是基于每个类的视图,它把性能消耗具体到actor、actor组件和函数顶层节点上。需要注意的是大多数actor组件和函数所占用时间已经考虑载了actor时间中,所以您不能简单地把它们相加。
这个视图可以用于简单地查看类的层次结构,比如,查看更新AI花费了多少时间或者在执行UnrealScript是花费了多少时间。
Function call graph(函数调用图)
这个标签面板显示了当前选中帧的函数调用图。
Aggregate function summary(合计函数概要)
这个标签面板和function summary(函数概要)面板类似,只是它把整个捕获的时间间隔的信息聚集到一起了。它把独占时间、非独占时间和函数调用数量聚集起来,最大独占时间和最大非独占时间分别是单独帧的最大值,其它的值是帧平均值。
合计的函数调用图表
所有执行的函数的调用图表,是在整个捕获期间的函数调用的合计信息。