GS2-Inbox マスターデータリファレンス

マスターデータのフォーマット

{
  "version": "2020-03-12",
  "globalMessages": [
    {
      "name": "[string]グローバルメッセージ名",
      "metadata": "[string]メタデータ",
      "readAcquireActions": [
        {
          "action": "[string]入手アクションで実行するアクションの種類",
          "request": "[string]アクション実行時に使用されるリクエストのJSON文字列"
        }
      ],
      "expiresTimeSpan": {
        "days": "[int]日数",
        "hours": "[int]時間",
        "minutes": "[int]分"
      },
      "messageReceptionPeriodEventId": "[string?]メッセージ受信期間イベントID"
    }
  ]
}

モデル

GlobalMessage

グローバルメッセージ

グローバルメッセージはゲームプレイヤー全体にメッセージを届ける仕組みです。

グローバルメッセージには有効期間を設定でき、各ゲームプレイヤーはグローバルメッセージを受信する処理を実行することで
有効期間内のグローバルメッセージの中で未受信のメッセージを自分のメッセージボックスにコピーします。

TimeSpan

タイムスパン

日、時間、分の組み合わせとして期間を表します。受信時刻を基準としたメッセージの有効期間を定義するために使用されます。例えば、7日、0時間、0分のタイムスパンは、ユーザーが受信してから正確に1週間後にメッセージが期限切れになることを意味します。

AcquireAction

入手アクション

報酬としてメッセージに添付される単一の入手アクションを表します。アクションタイプ（例：インベントリへのアイテム追加、通貨増加）とそのリクエストパラメータで構成されます。メッセージが開封されると、これらのアクションがトランザクションに組み立てられ、実行されてユーザーに報酬が配布されます。