新增自定义数据功能｜UWA Gears V1.0.7

UWA Gears 是UWA最新发布的无SDK性能分析工具。针对移动平台，提供了实时监测和截帧分析功能，帮助您精准定位性能热点，提升应用的整体表现。

本次版本更新新增了自定义数据功能，支持灵活定义和捕获关键性能指标，满足特殊场景的分析需求。同时，导出数据新增卡顿率以及CPU、GPU和电池的平均温度和最大温度参数，为安卓应用性能优化提供更加全面的数据支持。

以下是本次版本更新的主要功能介绍：

自定义数据功能

新增的自定义数据功能，旨在帮助大家更灵活地记录和分析项目中关键的性能指标。通过将Gears提供的SDK集成到项目中，您可以在代码的关键位置调用自定义打点函数，记录指定的性能数据（例如资源加载时间、逻辑执行耗时、怪物数量等）。在使用Gears进行测试时，这些自定义数据可实时同步至Gears进行展示，方便研发团队直观分析性能情况，快速定位问题根源。

支持范围
目前，自定义数据功能现已支持所有的主流引擎平台，包括Unity、Unreal（UE）、Cocos 等。大家可以根据项目需求选择适合的SDK进行集成，并实现性能数据的自定义捕获与分析。以下将以Unity引擎作为示例进行说明。

SDK获取位置
首先需要将Gears更新至最新版本，在Gears的安装目录下的bin\sdk文件夹中可以找到以下文件：

1. Android Native
在AndroidNative文件夹中，包含arm64-v8a和armeabi-v7a两种架构的动态链接库以及头文件AndroidTrace.h。

2. Unity SDK
在Unity文件夹中获取GearsSDK_Android.unitypackage文件，适用于Unity项目的性能测试。

集成SDK
将GearsSDK_Android.unitypackage拖动至Unity项目中，并点击“import”进行导入。

导入之后，SDK的全部文件位于Assets\Plugins文件夹内，便于管理。

SDK接口介绍
1. 记录整型值

• 方法名：UWAGears.Sample
• 用途：记录指定事件的整型数据
• 调用格式：

UWAGears.Sample(string eventName, int val);

• 参数说明：
  • eventName：事件名称，长度不超过100个字符
  • val：整型数据值
• 展示格式：(I)<eventName>

2. 记录浮点值

• 方法名：UWAGears.Sample
• 用途：记录指定事件的浮点数据
• 调用格式：

UWAGears.Sample(string eventName, double val);

• 参数说明：
  • eventName：事件名称，长度不超过100个字符
  • val：浮点数据值
• 展示格式：(D)<eventName>

3. 开始采样

• 方法名：UWAGears.BeginSample
• 用途：开始对指定代码段的性能采样
• 调用格式：

UWAGears.BeginSample(string eventName);

• 参数说明：
  • eventName：自定义标签名称，长度不超过100个字符
• 展示格式：(S)<eventName>
• 注意事项：需要配合UWAGears.EndSample使用
• 示例代码：

4. 结束采样

• 方法名：UWAGears.EndSample
• 用途：结束当前代码段的性能采样
• 调用格式：

UWAGears.EndSample();

• 注意事项：必须在与UWAGears.BeginSample相同的线程中调用

5. 添加书签

• 方法名：UWAGears.AddTag
• 用途：为指定事件添加书签
• 调用格式：

UWAGears.AddTag(string tagName);

• 参数说明：
  • tagName：书签名称，长度不超过100个字符
• 注意事项：确保当前书签名称与前一个不同

Gears中自定义数据参数位置
自定义数据参数默认位于Gears参数面板的底部。大家可以通过排序按钮调整其上下位置，双击自定义数据参数即可在数据显示区域快速定位对应的参数位置。同时，点击 “+” 按钮可以展开所有自定义数据事件，方便进行更详细的分析。

导出数据新增卡顿率和温度参数

新版本中，在导出的CSV表格数据中新增了卡顿率（Stutter %）、CPU、GPU及电池的平均温度和最大温度参数，帮助开发者更直观地了解应用运行时的性能表现。

新用户可以通过访问UWA官网Gears产品介绍页进行下载体验，老用户可以在软件内点击主界面右上角的【检查更新】更新至最新版本。

---

如果您在使用过程中遇到任何问题，可以通过UWA官方QQ群找到我们，或者前往问答社区进行提问，我们将竭诚为您提供支持。

问答社区链接：https://answer.uwa4d.com