GS2-Inbox 마스터 데이터 레퍼런스

마스터 데이터 포맷

• JSON

{
  "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

획득 액션

보상으로 메시지에 첨부되는 단일 획득 액션을 나타냅니다. 액션 타입(예: 인벤토리에 아이템 추가, 통화 증가)과 그 요청 파라미터로 구성됩니다. 메시지가 개봉되면 이 액션들이 트랜잭션으로 조립되어 실행되고, 사용자에게 보상이 지급됩니다.