数据模型

本文介绍 Framedash SDK 收集和发送的数据结构。

事件

所有遥测数据都以事件的形式发送。每个事件包含通用字段和自定义属性。

通用字段

字段	类型	说明
event_type	string	事件类型（例：performance_sample、player_death）
timestamp	ISO 8601	事件发生时间
session_id	UUID	游戏会话 ID
device_id	string	设备标识符
build_id	string	构建版本

性能采样

SDK 自动收集的性能数据：

字段	类型	单位
fps	float	frames/sec
frame_time	float	ms
gpu_time	float	ms
memory_used	int64	bytes
position	vec3	world units

自定义事件

开发者定义的游戏专属事件。可在 properties 字段中存储任意 JSON 对象。

会话

从游戏启动到结束为一个会话。会话包含以下元数据：

• 设备信息（OS、GPU、RAM）
• 构建信息（版本、配置文件）
• 玩家信息（可选）

下一步

• API 参考 — 通过 REST API 访问数据
• 热力图 — 位置数据的可视化