每个游戏开发者都有一个共同的愿望，那就是能够在无需复现玩家反馈的卡顿现象时，快速且准确地定位卡顿的根本原因。为了实现这一目标，UWA GPM 2.0推出了全新功能 - 卡顿帧堆栈，旨在为开发团队提供高效、精准的卡顿分析工具。在这篇文章中，我们将从三个方面详细介绍如何高效使用「卡顿帧堆栈」功能，并通过代码样本帮助开发者实现对玩家端卡顿问题的精细化定位。
定位卡顿细节三部曲
步骤 1：发现特定情况下的卡顿，以及顶层函数
在卡顿帧堆栈异常上报的条件下，GPM 2.0报告将显示玩家游戏时的卡顿帧堆栈信息及当时的画面截帧。例如，在Demo项目中，开发者可以查看如下堆栈表现图，详细展示了特定情况下的卡顿信息。以Demo项目为例，可以看到如下图的堆栈表现。
步骤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
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 多维数据与实时截帧完美结合》
