資料模型
說明 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）
- 建置資訊（版本、設定檔）
- 玩家資訊（選填）