解锁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：
邮件：[e-mail]
 

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 多维数据与实时截帧完美结合》