性能热力图

性能热力图是 Framedash 的核心功能，可将性能数据叠加显示在游戏地图上。

概述

SDK 收集的性能采样包含位置信息（世界坐标）。将这些数据绘制到地图图像上，并通过颜色渐变可视化呈现，即为热力图。

可视化的指标

• FPS: 帧率分布。红色区域表示性能较低
• 帧时间: 每帧处理时间
• GPU 时间: 定位渲染瓶颈
• 内存使用量: 发现内存泄漏

筛选

地图详情页的控件可按以下条件收窄视图：

• 指标: FPS、帧时间、GPU 时间或内存（性能模式）；事件模式下按事件名筛选
• 单元格大小: 聚合网格的大小（5m / 10m / 25m / 50m）
• 时间范围: 最近 1 / 7 / 14 / 30 天
• 构建: 选择一个构建查看（无法同时显示多个构建）
• 平台: windows、android 等
• 颜色模式: 在相对着色与阈值着色之间切换
• Z 轴（高度）: 限定高度范围的切片器

当性能数据包含分辨率、GPU、存储或构建配置属性时，你还可以按这些维度收窄。阈值配置可让你按属性切换合格/不合格阈值。

构建对比

热力图本身只显示一个构建。要对比两个构建，请使用回归页面。它选择一个基准构建和一个候选构建，并以数值表格对比 FPS、帧时间等指标。它不是并排显示两张热力图的视图。

编辑器内云端热力图

UE5 SDK 0.1.7 及更高版本新增了 Framedash Heatmap 标签页（来自 FramedashEditor 模块），可直接在编辑器中获取云端聚合的热力图。0.1.13 及更高版本中，请在非 Play-in-Editor（PIE）状态下启用各关卡视口的 Show > Framedash Heatmap；热力图会在 PIE 期间自动暂停，并在结束后恢复。详见 UE5 SDK 指南。

Unity SDK 0.1.4 及更高版本新增了仅供编辑器使用的 Framedash.Editor 程序集，会把云端聚合的热力图单元格作为半透明四边形叠加显示在 SceneView 中。详见 Unity SDK 指南。

PNG 导出

地图详情页（项目 → [项目] → 地图 → [地图]）可将当前热力图视图导出为 PNG 图像。图像在客户端渲染，文件名根据地图名称和模式生成。

在 Free 计划下，导出图像右下角会带有一个小的”Powered by Framedash”水印。付费计划（Starter 及以上）导出时不含任何品牌标识。

地图图像

热力图的背景地图图像可通过以下方式注册：

1. 手动上传: 从仪表盘或 API 上传图像
2. CI 自动截取: 从构建流水线自动生成附带世界坐标元数据的图像

下一步

• CI 性能分析: 自动化性能测试
• API 参考: 管理地图数据