コンテンツレジストリ

コンテンツレジストリは、ゲーム内のマップ・アイテム・スキルなどの静的メタデータを管理し、テレメトリデータと紐づける機能です。

なぜ必要か

汎用のテレメトリツールでは、イベントデータに含まれる ID が何を指しているかわかりません。コンテンツレジストリを使うことで:

• item_id: "sword_01" → 「炎の剣 (レア / 武器カテゴリ)」
• map_id: "map_desert" → 「砂漠アリーナ (PvP マップ)」

テレメトリにゲーム文脈を付与し、意味のある分析を可能にします。

コンテンツの種類

種類	説明	例
map	ゲームマップ	ステージ、アリーナ、ワールド
item	ゲーム内アイテム	武器、消耗品、装備
skill	スキル/アビリティ	攻撃、バフ、パッシブ
character	キャラクター	プレイアブル、NPC
custom	カスタム定義	任意のゲーム要素

データ同期

コンテンツレジストリのデータは、ゲームのマスタデータと同期します。

手動登録

ダッシュボードから個別に登録するか、REST API で登録します。POST /v1/content エンドポイントは X-Project-Id ヘッダーを必須とし、エントリを entries エンベロープでラップします:

curl -X POST https://app.framedash.dev/api/v1/content \
  -H "X-API-Key: fd_your_api_key_here" \
  -H "X-Project-Id: your-project-uuid" \
  -H "Content-Type: application/json" \
  -d '{
    "entries": [
      {
        "contentType": "item",
        "contentId": "item_hp_01",
        "displayName": "Health Potion",
        "metadata": { "rarity": "common", "category": "consumable" }
      }
    ]
  }'

一括インポート (推奨)

CI パイプラインから CLI でマスタデータを JSON 一括インポートします。CLI はエントリのプレーンな JSON 配列を受け付けます (entries エンベロープは不要):

framedash content import ./game-content.json

game-content.json の形式:

[
  {
    "contentType": "item",
    "contentId": "item_hp_01",
    "displayName": "Health Potion",
    "metadata": { "rarity": "common", "category": "consumable" }
  }
]

各エントリには contentType、contentId、displayName が必須で、metadata は任意です。

テレメトリとの連携

SDK でイベントを送信する際に、対応するコンテンツ ID (contentId に対応する map_id、item_id など) を含めると、ダッシュボードでコンテンツ名やメタデータが自動表示されます。

次のステップ

• API リファレンス: コンテンツレジストリ API
• CLI リファレンス: データ同期コマンド