内容注册表

内容注册表是管理游戏中地图、物品、技能等静态元数据，并将其与遥测数据关联的功能。

为什么需要它

通用遥测工具无法理解事件数据中 ID 所代表的含义。使用内容注册表可以：

• item_id: "sword_01" → “烈焰之剑（稀有 / 武器类别）”
• map_id: "map_desert" → “沙漠竞技场（PvP 地图）”

为遥测数据赋予游戏上下文，使有意义的分析成为可能。

内容类型

类型	说明	示例
map	游戏地图	关卡、竞技场、世界
item	游戏内物品	武器、消耗品、装备
skill	技能/能力	攻击、增益、被动
character	角色	可操作角色、NPC
custom	自定义类型	任意游戏元素

数据同步

内容注册表的数据与游戏的主数据保持同步。

手动注册

从仪表盘或 REST API (POST /v1/content) 逐个注册。

批量导入（推荐）

从 CI 流水线使用 CLI 以 JSON 格式批量导入主数据：

framedash content import ./game-content.json

game-content.json 格式：

[
  {
    "type": "item",
    "external_id": "item_hp_01",
    "name": "Health Potion",
    "metadata": { "rarity": "common", "category": "consumable" }
  }
]

与遥测数据的联动

在使用 SDK 发送事件时包含 external_id，即可在仪表盘中自动显示内容名称和元数据。

下一步

• API 参考 — 内容注册表 API
• CLI 参考 — 数据同步命令