解锁GPM 2.0「卡顿帧堆栈」|代码示例与实战分析

解锁GPM 2.0「卡顿帧堆栈」|代码示例与实战分析

每个游戏开发者都有一个共同的愿望,那就是能够在无需复现玩家反馈的卡顿现象时,快速且准确地定位卡顿的根本原因。为了实现这一目标,UWA GPM 2.0推出了全新功能 - 卡顿帧堆栈,旨在为开发团队提供高效、精准的卡顿分析工具。在这篇文章中,我们将从三个方面详细介绍如何高效使用「卡顿帧堆栈」功能,并通过代码样本帮助开发者实现对玩家端卡顿问题的精细化定位。

定位卡顿细节三部曲

步骤 1:发现特定情况下的卡顿,以及顶层函数
在卡顿帧堆栈异常上报的条件下,GPM 2.0报告将显示玩家游戏时的卡顿帧堆栈信息及当时的画面截帧。例如,在Demo项目中,开发者可以查看如下堆栈表现图,详细展示了特定情况下的卡顿信息。以Demo项目为例,可以看到如下图的堆栈表现。


此处“调用栈深度”设置为5(默认为1)

步骤2:根据出现时机及函数,细化相关逻辑打点
使用GPM SDK提供的API,开发者可以根据游戏特性和性能瓶颈,合理制定打点策略。例如,对高频调用的函数、资源加载流程、复杂运算逻辑等进行重点打点。

以Demo项目为例,从步骤1的结果可以看到,DOTweenComponent.Update 自身的耗时较高,说明很可能是DOTween动画插件的更新触发的回调带来高耗时,结合截图和时机看,可以判断出可能是启动画面结束,切换场景的逻辑,从而找到对应代码进行打点。

以下是通过Push/Pop的成对调用,对其中的逻辑进行打点。

也可通过using+Auto的方式,对作用域中的逻辑打点。

步骤3:获取玩家端耗时细节
将进行了逻辑打点的新版本更新至玩家端后,在新的异常报告中即可以看到打点部分的详细耗时。

此时我们发现,耗时的主要部分来自于自定义PlayerPrefs的初始化检测,以及LuaManager的清理操作。

通过上述分析,开发者可以更高效地定位和解决卡顿问题,提升玩家体验。

详细拆分卡顿模块

  • 核心模块耗时拆分

核心模块通常包括游戏的主要业务逻辑部分,如角色同步、寻路、网络消息处理、UI动画等。拆分后我们就可以在卡顿堆栈中初步判定高耗时的主要原因,以及明确下一步的排查方向。

如观察下图中的卡顿堆栈,可以看到耗时主要和NPC的预加载有关,同时单帧内处理了较多的网络消息等。

  • 子线程耗时拆分

当项目中存在子线程任务,且有主线程同步等待的机制时,可以针对这部分耗时进行打点,当主线程中的卡顿耗时集中在同步等待时,就可以在子线程中查看与什么任务有关。

注意:子线程中函数的开始时间可能早于主线程当前帧的开始时间,所以有可能会出现总耗时大于帧耗时的情况。

各引擎/平台使用方式及调用方式

为了更好地利用卡顿帧堆栈功能,我们需要了解不同引擎和平台的使用方式及调用方式。

  • C#(适用于Unity)‌

在Unity中,开发者可以使用Push/Pop成对调用的方式对逻辑部分进行打点,这种方式要注意中间避免出现提前return的if分支。

以及通过using+Auto触发作用域打点的方式进行打点,这种方式即使包含了return逻辑也不影响。

对于Unity中HybridCLR的C#热更新框架,可以直接使用GpmSample打点,通过热更即可快速迭代上线,使打点堆栈生效;非热更的部分则需要通过版本更新生效。

  • C++(适用于Unreal)‌

在Unreal中,开发者也可以通过Push/Pop成对调用的方式来进行打点。

以及通过GpmSampleAuto析构触发作用域打点的方式,可以配合{}的使用,指定作用范围,这种方式同样不受提前return的影响。

  • Lua(适用于Unity/Cocos/Unreal)‌

Lua脚本语言在多个游戏引擎中都有广泛应用。在Unity、Cocos和Unreal中,开发者都可以在Lua中使用GPM SDK提供的API进行打点。

在Cocos中,GPM SDK会自动完成C和Lua的绑定。

而Unity和Unreal,开发者可以通过函数导出的方式绑定Lua接口。

  • JS(适用于Cocos)‌

在Cocos引擎中,开发者可以直接在JS代码中使用GPM SDK提供的API进行打点。Cocos中GPM SDK会自动完成C和JS的绑定。


GPM 2.0「卡顿帧堆栈」功能为游戏研发团队提供了精准、直观的卡顿分析能力,让开发者能够快速锁定卡顿根因,优化游戏性能。无论是Unity还是其他游戏引擎,都可以通过自动或手动打点的方式,深入剖析各个环节的性能开销。如果你对游戏性能优化有更高要求,不妨试试GPM 2.0,让你的游戏体验更流畅!

关于GPM 2.0

GPM 2.0 是一款专为上线或测试阶段的游戏项目打造的高效性能监测工具。它不仅深入捕捉宏观性能数据,还通过其独特的性能无损截图功能,让开发者在不影响玩家体验的前提下,全面掌握玩家运行时的关键细节,从多个维度优化游戏的性能表现,提升整体用户体验。

如果您的项目也希望体验GPM 2.0的强大功能,欢迎随时与UWA取得联系。我们将为您提供免费试用机会,并在试用期间全程支持服务搭建、数据分析与反馈,确保您能够充分体验GPM 2.0带来的价值。

联系UWA:
邮件:sales@uwa4d.com
微信号:17502188376

GPM 2.0新功能 集锦
《GPM 2.0 全新发布「卡顿帧堆栈」功能|精准高效定位游戏玩家端性能》
《深入解析「卡顿帧堆栈」》
《GPM 2.0 重新定义性能监测与优化|从未知到已知,从被动到主动》
《UWA GPM 2.0 重新定义性能监测与优化|如何高效预警和定位玩家端的性能问题》

GPM 2.0案例精讲 集锦
《我们的目标是不耗电、不发烫、不闪退》
《冒险闯关类玩家关注的四大体验》
《玩家端性能数据 一手掌握》
《造成设备功耗高的罪魁祸首》
《海外市场设备适配性优化实战》
《5000人测试背后的秘密》

GPM 2.0实操篇 集锦
《GPM 2.0 实操之Session篇之如果闪退是因为内存崩了》
《GPM 2.0 应用场景实例之解决让人头疼的问题》
《GPM 2.0 助力设备监测、行为分析与性能优化|玩家共测新体验》
《GPM 2.0 API 功能助力定制你的性能优化》
《GPM 2.0 驱动优化与投放决策|硬件性能一目了然》
《GPM 2.0 多维数据与实时截帧完美结合》